OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: Re: DOCBOOK: generating a reference manual from source code

/ Stefan Seefeld <seefeld@sympatico.ca> was heard to say:
| However, in case of docbook I'm missing a couple of entities (or is it just
| the documentation that lacks...?): typedefs, modules, enums for example
| are missing.

DocBook is intended for software documentation, not necessarily a
complete representation of all the abstract syntax elements of a
particular language.

I'm not sure exactly what you're generating, but I suggest that a good
working solution is to use a role attribute to distinguish between the
cases on some more general element.
| Is there any document that I could consult to get more information about
| the kind of problem I'm trying to solve ?

The documentation for the new OO elements needs to be updated.

                                        Be seeing you,

Norman Walsh <ndw@nwalsh.com>      | The common excuse of those who
http://www.oasis-open.org/docbook/ | bring misfortune on others is that
Chair, DocBook Technical Committee | they desire their
                                   | good.--Vauvenargues

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC