This is the mail archive of the
mailing list for the DocBook project.
Re: DocBook 4.0: ClassSynopsis
- To: docbook at lists dot oasis-open dot org
- Subject: Re: DOCBOOK: DocBook 4.0: ClassSynopsis
- From: "Fred L. Drake, Jr." <fdrake at acm dot org>
- Date: Tue, 21 Dec 1999 10:10:34 -0500 (EST)
- References: <7151-Tue21Dec1999092025email@example.com>
- Reply-To: docbook at lists dot oasis-open dot org
Norman Walsh writes:
> At the face-to-face meetings in conjunction with XML'99, the
> DocBook Technical Committee decided to add the ClassSynopsis
> element to DocBook V4.0, with a few small modifications:
This is good!
> - The "verbish" names have been made "nounish". Exception has
> been renamed ExceptionName, etc. Several of the elements will
> also be made available inline.
But this is mixed. I understand the desire to make the names
similar to those of other, existing DocBook elements, but the lengthy
names are one of the reasons I don't see that DocBook is a good match
for my application (with lots of occaisional authors).
> - A ClassSynopsisInfo element was added
Perhaps this shows that I don't know enough about the existing
DocBook, but ... what is the indended use? Is this for a source-style
synopsis presentation as typically found in section 2 & 3 man pages?
(I'm presuming this based on the content model and %linespecific.attrib;
in the attribute list.)
> Attached is the new DTD fragment, you will find complete examples
> at http://nwalsh.com/docbook/edbsyn/, including some sample
> instances and stylesheets which format them.
I'll try and take a look when I have a few minutes. Hopefully this
Fred L. Drake, Jr. <firstname.lastname@example.org>
Corporation for National Research Initiatives