On Monday 03 February 2003 02:36 pm, Jeff Garland wrote:
> >Does Doxygen have the ability to do that kind of organization? If
> >it does, we can use it. Otherwise, I'll have to think about this
> >a bit more...
>
> Yes, doxygen has the ability to define arbitrary groups -- or in
> my case this lines up with certain namespaces.  I'm worried that
> this approach might be fairly tough to use.  Another way
> we might do it is to process each group of source files to generate
> 3 separate output files from doxygen.  Thus a kind of pre-sectioning
> of the data which could then be included.  Thoughts?
>
> Jeff

I've just added a way to do this. First of all, you can now provide the 
Doxygen->BoostBook stylesheet with a list of headers it should output via the 
XSL parameter "boost.doxygen.headers". Use it with xsltproc like so:

  xsltproc --stringparam boost.doxygen.headers "c_local_time_adjustor.hpp 
date.hpp" ../boostbook-xsl/doxygen/doxygen2boostbook.xsl doxygen-all.xml > 
doxy-to-bb.xml

I've also made it so that nested <library-reference> elements do not produce 
additional sectioning, but do transform the underlying elements. So, for 
instance, you can call xsltproc as above with the header list for the 
"Generic Elements" section and put the result into reference/generic.xml, and 
do the same for the Gregorian Date-Time system stuff with the result going to 
reference/gregorian.xml, and have a reference.xml that looks like this:

<library-reference>
   <section>
    <title>Generic Elements</title>
    <xi:include href="reference/generic.xml"/>
  </section>

  <section>
    <title>Gregorian Date-Time system stuff</title>
    <xi:include href="reference/gregorian.xml"/>
  </section>
</library-reference>

Will that work for you?

        Doug


-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to