Rene Rivera <[EMAIL PROTECTED]> writes:

> [2002-11-16] Douglas Gregor wrote:
>
>>(i) Jam integration (Difficulty: 3)
>>Find a way to integrate building documentation into the build process,
> using 
>>Jam. For instance, it would be great to be able to type "bjam doc-pdf" and 
>>get back a PDF file containing Boost documentation. This is an ongoing task 
>>that may start simple (C++XML->DocBook via an XSLT processor, then 
>>DocBook->HTML via an XSLT processor) and will grow in complexity 
>>(Doxygen->C++XML->DocBook->FO->PDF...) as we learn more.
>
> This should not be a big problem to implement in BBv2. So when the time
> comes, I'll volunteer to do some of this. The main problem will be deciding
> on the set of tools to use, which must be command line useable.

Oh, whoops! I'll put Rene on the Wiki page, then ;-)

> On this note I'd also like to bring up another documentation
> requirement/wish. It would be nice to be able to document and/or
> process other languages that can map directly to the same C++
> constructs. In particular I'm currently contemplating how to
> generate the HTML version of the documentation for the new BBv2
> system. This documentation, like Doxygen and Synopsis, comes from
> code comments in the *.jam files. Currently we have it so that it
> auto-generates console output documentation. The transformation
> would be: BBv2(bjam)->C++XML or DocBook->...

How can that map directly to the same C++ constructs? I guess we have
"classes" and such... but it really seems quite different to me. I
await enlightenment ;-)

-- 
                       David Abrahams
   [EMAIL PROTECTED] * http://www.boost-consulting.com
Boost support, enhancements, training, and commercial distribution



-------------------------------------------------------
This sf.net email is sponsored by: To learn the basics of securing 
your web site with SSL, click here to get a FREE TRIAL of a Thawte 
Server Certificate: http://www.gothawte.com/rd524.html
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to