> On Monday 03 February 2003 09:41 am, Douglas Gregor wrote:
> > I know Doxygen does have some of the clauses (e.g., returns). I'll work on
> > getting those mapped properly Real Soon Now (TM).
>
> ... done for returns.
>
> The Date-Time library's reference documentation is started to look quite nice.
> A little more work and some fixing on the Doxygen output side (anyone want to
> take this on?) and we'll have a usable system.

Sure I'll take this since I'll initially be the primary beneficiary.  Just
make a list of issues...

I have taken a look at this and I agree, it is looking pretty good.  So now,
I'm starting to wonder how all the pieces are going to go together.  So far,
based on your examples I have taken several of the introductory documentation
pages from date_time and converted them to XML -- piece of cake.

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, actually this brings up a question of whether I processed things as
you intended:

 -- I used your doxygen-all.xml file (presumably I could recreate this by
    running Doxygen 1.2.18 and xsltproc with boostbook-xsl/doxygen/collect.xsl)
 -- 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).

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?

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

Reply via email to