Douglas Gregor wrote:
> > Currently there is no method how to add some structure to
>
> doxygen-generated
>
> > reference ( At least I don't know about any ). I think, that for larger
>
> references
>
> > it would be nice to have this posibility.
>
> Well, if your structure is on a per-file basis, you can just generate
> multiple BoostBook files (each from a different set of headers) and then
> XInclude them into a larger BoostBook document for later processing. I
> haven't tried it yet (though I'll probably give it a whirl with Signals
> when I get the chance)...
I've actually wanted something similiar. There were two recommented ways to
write documentation: one is "everything in BoostBook" and another is
"everything in Doxygen", but I'd prefer to have "overview" in BoostBook with
reference in DocBook.
It required some changes of V2 code for boostbook, and it's not 100% ready,
but usable. Here's what my Jamfile contains:
import toolset : using ;
using doxygen ;
boostbook program_options : po.xml
: <xsl:path>bin/gcc/debug
# Actually, this is rude hack
# But boostbook isn't teached to handle includes of
# generated sources yet.
;
# Main target to extract doxygen comments and convert them to
# BoostBook xml.
xml autodoc :
[ doxygen extracted :
[ GLOB ../../../boost/program_options : *.hpp ] ] ;
And "po.xml" has <xi:include href="autodoc.xml"/> near the end. This scheme
can be used in cases where there are several xml files produced from doxygen,
except that Doxygen now unconditionally creates directory called "xml" and
that won't work when doxygen is called on different sets of files.
- Volodya
>
> Doug
>
>
>
>
> -------------------------------------------------------
> This SF.Net email sponsored by: Parasoft
> Error proof Web apps, automate testing & more.
> Download & eval WebKing and get a free book.
> www.parasoft.com/bulletproofapps1
> _______________________________________________
> Boost-docs mailing list
> [EMAIL PROTECTED]
> Unsubscribe and other administrative requests:
> https://lists.sourceforge.net/lists/listinfo/boost-docs
-------------------------------------------------------
This SF.Net email sponsored by: Parasoft
Error proof Web apps, automate testing & more.
Download & eval WebKing and get a free book.
www.parasoft.com/bulletproofapps1
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
