| Karl,
I believe the confusion here is that <example> without an argument
outputs a heading "Example", but is still considered to be an informal
example. A formal example takes an argument and numberes the example
according to the caption numbering parameters, ie Example 1-1 Caption.
The <table> tag without an argument outputs no heading and is
an informal table.
Hope this explanation helps.
|
|
Karl is correct that there is an inconsistency in the use of
the formality of examples. I modified, for V1.0 (also in BL8, I
believe) the definition for <example> so that it requires at least
one argument. This will avoid the examples numbered 0 problem, but
it will cause files that use:
<example>
<code_example>
...
<endcode_example>
<endexample>
to break. (Donna Rosenthal's file with the creeping page numbers
has a number of these; I am not a bit worried that failing to signal
this earlier will cause files to break under V1.0... help? comments?)
The section on Figures in the SDMLUG has been revised a good bit
since the BL8 version; I particularly made sure that it explains
the difference between formality and non-formality in figures, and
then discusses <example> as an alternate identification method for
technical manuals in which there is a distinction between a <figure>
and an <example>.
-pa
|