[debiandoc-sgml-pkgs] Bug#413873: SGML shorthand are not meant for nesting

[Osamu Aoki]

reassign 413873 userv 1.0.5
thanks

Ian, I am sure you know better than me so please feel free to correct
me.

<taglist>
<tag/<tt/if <var/condition///
<tag/<tt/elif <var/condition///
<tag/<tt/else//
<tag/<tt/fi//
<item>
.....

This is the part causing problem.  You are using short hand notation of SGML. 
If I use my human text parser, I think your first <tag/ line is expanded to

<tag><tt>if <var>condition</var></tt></tag>

But is multiple tag without <item> allowed?

Since the last defined <tag> component has priority, it only prints "fi".

tag is meant to have word only anf I think this comes from the DTD.

Since <example> is not allowed, I do not ave easy solution.

So this is feature of debiandoc-sgml.

For me I suggest to use <list> in nested form.  <item> in list can have
paragraph <p> or even <example> so you can have multiline.  For example
following structure produce closer to what you epect:

<list>
<item><example>if <var>condition</var>
 ...
elif <var>condition</var>
 ...
else
 ...
fi</example>
</item>
<item>
<list>
<item>
Lines following <prgn/if/ are interpreted only if the condition is
true.  Many conditions are properties of parameter values.  Most
parameters have a single string as a value; however, some may yield
zero or several strings, in which case the condition is true if it is
true of any of the strings individually.  Parameters are described
below.
<p>

The conditions are:
</item>
</list>

</list>


Good luck.




Osamu