For these examples, assume that you've declared these two file entities at the top of your help volume:
<!entity FirstPicture FILE "first.tif"> <!entity SecondPicture FILE "second.pm">
The following figure displays the graphic in the first.tif file and displays a number (by default) and caption:
<figure entity=FirstPicture> Here's the First Picture <\figure>
Here's a figure that displays the second.pm file without a number or a caption:
<figure nonumber entity=SecondPicture> <\figure>
If you add an ID to a figure, you must have a caption. The caption is needed in case an <xref> uses the figure's ID; if so, the caption is inserted in place of the <xref> and becomes a hyperlink to the figure.
The following figure is an execution hyperlink that runs the xclock program:
<figure entity=SecondPicture ghyperlink="xclock &" glinktype=execute> Choose This Figure to Start the Clock <\figure>