DocBook Questions

From: Reece Dunn (msclrhd_at_[hidden])
Date: 2004-11-19 05:34:46

I have a few questions regarding DocBook:

[1] The new docbook generation process places the HTML files for various
libraries in their own directories, but this does not work for
docbook-generated reference files.

Is there going to be support to put the docbook reference files in a
similar directory structure, maybe organised by namespace?

[2] The generated reference has the form

Class [name]
[ns-qualified-name]
Synopsis
...
Description
[description]
...

Would it be better to have description at the top? For example:

Class/Function/... [ns-qualified-name]
[description]
Synopsis
...
...

[3] Is there any way to deal with long names in the synopsis? For
example, I have a class that has:

boost::scalar_property< boost::readonly_object_property< position,
area,&area::get_center > > center;

as a public data member!

(NOTE: I know that the synopsis is defined using a PRE element and they
do not wrap lines.)

Regards,
Reece