Re: [Boost-docs] Can't build bjam docs

Subject: Re: [Boost-docs] Can't build bjam docs
From: John Maddock (john_at_[hidden])
Date: 2007-09-18 08:52:48

Rene Rivera wrote:
> I'm attempting to build the bjam docs (root/tools/jam/doc) and having
> some problems. First are the warnings about deprecated hard-returns:
>
> bjam.qbk:117: warning: in column:69, [br] and \n are deprecated.
> bjam.qbk:119: warning: in column:56, [br] and \n are deprecated.
> bjam.qbk:124: warning: in column:50, [br] and \n are deprecated.
> bjam.qbk:130: warning: in column:37, [br] and \n are deprecated.
> ...
>
> My question on those; Is there an alternative? I'm using the "\n"
> inside a table cell to get multi-line content in the cells
> <http://boost.org/doc/html/jam/building.html>.

>From quickbook 1.4 onwards, you can have paragraphs in table cells:

[table
[[heading1][heading2]]
[[one para][two

            para]]
]

> Second, I'm getting xslt errors because of bad output from the
> admonitions. The output created has unbalanced para tags:
>
> <warning>
> <para>
> <para>
> For targets with build actions: if their build actions exit with
> a nonzero return code, dependent targets will still be built.
> </para>
> </warning>

I've never seen that before and I use a lot of admonishments: what does the 
quickbook look like?

John.