Re: DOCBOOK: ClassSynopsis one last time

[Dmitry Tsitelov <cit@comcon.spb.ru>]

Norman Walsh wrote:
> 
> 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?

Looks better, but we still have no chance to attach descriptions/infos
for Fields/Methods.

Sincerely,
Dmitry Tsitelov