DOCBOOK: ClassSynopsis one last time

[Norman Walsh <ndw@nwalsh.com>]

At the recent DocBook TC meeting, we took another look at ClassSynopsis.
The proposal as it stands now (and will appear in the next draft) is:

<!ELEMENT ClassSynopsis - - ((OOClass|OOInterface|OOException)+,
                             (ClassSynopsisInfo
                              |FieldSynopsis|%method.synop.class;)*)>

<!ELEMENT OOClass - - (Modifier*, ClassName)>
<!ELEMENT OOInterface - - (Modifier*, InterfaceName)>
<!ELEMENT OOException - - (Modifier*, ExceptionName)>

This additional wrapper reduces the ambiguity that arose in the
previous model when modifiers occured in several places.  The
model still assumes that the first OOClass is the base class
name and any other OOClasses are supertypes.

Is this progress? Does anyone have any additional comments?

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | Nature is amoral, not immoral.
http://www.oasis-open.org/docbook/ | [It] existed for eons before we
Chair, DocBook Technical Committee | arrived, didn't know we were
                                   | coming, and doesn't give a damn
                                   | about us.--Stephen J. Gould