<figure link="someimg.png" short="this is neat"> this will produce a little block that has 'Figure 1.1' as its header with an image (someimg.png) inside it. the image will have an alt value of 'this is neat' ... however, i think it would be more useful if in addition the header was: Figure 1.1: this is neat
Aah, your error: you assumed that "short" is the only attribute :) There is also a "caption" attribute, so you should use <figure link="kmail_identity.png" short="KMail Identity Screenshot" caption="Selecting the Identity tab in KMail" />