This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: ClassSynopsis one last time
- To: docbook at lists dot oasis-open dot org
- Subject: Re: DOCBOOK: ClassSynopsis one last time
- From: Dmitry Tsitelov <cit at comcon dot spb dot ru>
- Date: Fri, 03 Mar 2000 13:18:42 +0300
- References: <3825-Thu02Mar2000172926-0500-ndw@nwalsh.com>
- Reply-To: docbook at lists dot oasis-open dot org
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