Re: DocBook V5.2b08 available for review

[Norman Tovey-Walsh <ndw@nwalsh.com>]

Hello again,

In the test cases for enumsynopsis, I find:

  <enumitem>
     <enumidentifier>AlignHorizontal_Mask</enumidentifier>
     <enumvalue>AlignLeft | AlignRight | AlignHCenter | AlignJustify | AlignAbsolute</enumvalue>
  </enumitem>

That strikes me as very odd. If the markup is going to go to this level
of detail, shouldnât it also provide a way to identify the different
possible numerated values? Iâm not even sure this example makes sense.
Isnât the *value* of the AlignHorizontal_Mask itself an enumeration?

Maybe the example is wrong and it should be:

  <enumitem>
     <enumidentifier>AlignHorizontal_Mask</enumidentifier>
     <enumvalue>
       <enumsynopsis>
         <enumitem><enumidentifier>AlignLeft</enumidentifier></enumitem>
         <enumitem><enumidentifier>AlignRight</enumidentifier></enumitem>
         <enumitem><enumidentifier>AlignHCenter</enumidentifier></enumitem>
         <enumitem><enumidentifier>AlignJustify</enumidentifier></enumitem>
         <enumitem><enumidentifier>AlignAbsolute</enumidentifier></enumitem>
       </enumsynopsis>
     </enumvalue>
   </enumitem>

But thatâs not allowed. And Iâm not sure I want it to be. The values of an
enumeration are usually (more-or-less) tokens. To have an enumeration
value that is itself an enumeration seems â odd.

                                        Be seeing you,
                                          norm

--
Norman Tovey-Walsh <ndw@nwalsh.com>
https://nwalsh.com/

> Hanging is too good for a man who makes puns; he should be drawn and
> quoted.--Fred Allen

Attachment: signature.asc
Description: PGP signature