[Boost-users] QuickBook

Subject: [Boost-users] QuickBook
From: OvermindDL1 (overminddl1_at_[hidden])
Date: 2010-08-13 01:40:07

Attempting to use QuickBook to create both HTML and PDF documentation.

First of all, compiled just about everything I can compile in boost,
including about all the tools, on Ubuntu.

I created a directory named qb_test.

I created a file called test.qbk and filled it with:
"""
[article TestingArticle
        [quickbook 1.5]
        [version 0.1]
        [authors [, OvermindDL1]]
        [copyright 2010 OvermindDL1]
        [/ [purpose /WikiWiki/ style documentation tool]]
        [id test]
]

[section:intro Introduction]

This is just a simple testing thing, we shall see how it works overall...

[endsect]

[section:change_log Change Log]

[h3 Version 0.1]
* Initial creation...
* Two pages setup, intro and change_log

[endsect]
"""

I ran:
"""
quickbook test.qbk
"""

It created a test.xml file, not quite what I was looking for, I take
it that it does not call boostbook directly...

So then I started looking for how to call boostbook and became pretty
lost, for some reason I recall this being easier on Windows...

Decided to try to use bjam (although the project this is eventually
going into uses CMake, so no bjam eventually...), made a Jamfile
containing:
"""
project test
import boostbook : boostbook ;

boostbook test
        :
        test.qbk
        :
                <include>.
        ;

"""
And running bjam complains about not having found boost, which makes
sense since boost was build as a different user so its building
directory is inaccessible.

Basically I want to build a quickbook documentation for another very
large C++ project that itself uses CMake, how would I go about doing
this?  The quickbook documentation is lacking in how to get a finished
html/pdf/etc...