Re: [Boost-docs] few comments

From: Douglas Gregor (gregod_at_[hidden])
Date: 2003-07-14 01:15:11

> I have another comment regarding files. Currently my reference page is
starting
> to be quite long. It would be nice to be able to split it into several
pages.
>
> An idea would be to put each file into separate page and create one page
> with links to all these pages. ( or have a tag in main documentation to
generate
> such a list).

I'd generally prefer to use the method I mention below or some other
Doxygen-specific translation, because it can easily be done with sections in
BoostBook itself.

> 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)...

    Doug