>> Now in your examples you have a /reference subdirectory which seems >> like a good idea. So I'm assuming I'll want something similar >> for date_time, but with mostly generated content. I'm assuming >> I'll still want a reference.xml as an anchor to refer to the >> generated xml? > >Well, since the generated content will always go into a single file, and >that'll be the <library-reference> element, you can probably just >transform the Doxygen output directly to "reference.xml".
Ok. >You'll actually need to copy collect.xsl into the Doxygen XML output >directory (for now), because it looks for the Doxygen XML files relative >to the XSL stylesheet directory (I don't know why...). Ok. >> -- Then I ran >> xsltproc --xinclude boostbook-xsl/doxygen/doxygen2boostbook. xsl >doxygen-all.xml > dt_ref.boostbook >> xsltproc boostbook-xsl/docbook.xsl dt_ref.boostbook > dt_ref. docbook >> xsltproc -o dt_ref_html/ docboosk-xsl-1.60.1/html/chunk.xsl >> >> Anyway, just processing the reference piece like this created a couple >of anomolies (like not TOC and all the synopsis's combined >> into index.html). > >Right, because the top-level element is <library-reference>, which won't >have a TOC. You'll get the TOC if you integrate the reference into a ><library> element, which might look like this: > >...details snipped Ok, I'll give that a try. >If you then want to integrate this documentation with the rest of the >Boost documentation, remove the current <library> element for Date-Time >from libs/documentation/examples/boost.xml and put in an XInclude to your >new <library> element. Ok, will do. >> The other twist here is that I would like to section off the reference >documentation into parts: >> -- Generic elements >> -- Gregorian Date-Time system stuff >> -- Posix Time system stuff >> -- XYZ Time system stuff >> >> Any thoughts on how best to arrange this? > >In BoostBook, you can do this by adding <section> elements in the ><library-reference> element, e.g., > ><library-reference> > <section> > <title>Generic Elements</title> > <header name="blah"> ... </header> > </section> > > <section> > <title>Gregorian Date-Time system stuff</title> > <header name="wibble"> ... </header> > </section> > > ... ></library-reference> > >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 ------------------------------------------------------- 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
