Re: [Boost-docs] boostbook outside of boost

Subject: Re: [Boost-docs] boostbook outside of boost
From: John Maddock (john_at_[hidden])
Date: 2010-02-24 08:57:56

> I would like to use boostbook for documenting a non-boost C++ library.
> I currently use an autotools build system with doxygen to generate API
> documentation and I have a manual I have written for it in docbook. I
> would like to merge the docubook and doxygen stuff into a single tool
> so i can have references between the doxygen API documentation and the
> manual documentation with a consistent style.
> I figure this sort of thing is possible from reading the documentation
> on boostbook:
> However I have found no documentation on using boostbook outside of
> the boost jam based build system, or calling it manually or on how the
> boostbook/doxygen intergration works.
> Are there any example projects that are using boostbook outside of a
> jam based build system which I could take a look at or any relevant
> documentation I can read?

Not much, but take a look at the diagram here: to see how it
all fits together.

Then if you run bjam on a sample Boost library (maybe doc/test/ would be a
good one) with the -d2 option you'll see the actual commands used - it's
probably quicker to pick things up from there than to read the docs for all
the different tools involved ;-)

HTH, John.

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC