It seems that in boostbook code, <purpose> shouldn't really contain
paragraphs, but in quite a few cases they do which leads to paragraphs
inside paragraphs in some of the generated documentation. For an
<p>boost::any_cast — <p>Custom keyword cast for extracting a value
of a given type from an
<tt class="computeroutput"><a href="any.html" title="Class
This is invalid because <p> tags can't be nested. There are lots of
other examples of the same problem.
The funny thing is that boostbook already contains code for stripping
the paragraphs out - but it doesn't get called. Does anyone know if
there's a reason for this? Maybe to give authors more control over the
Anyway, I've attached a patch which turns it on in this case, I think
there might be other places in the boostbook code where it's
appropriate, but I haven't looked into it yet.
Daniel James wrote:
> Anyway, I've attached a patch which turns it on in this case, I think
> there might be other places in the boostbook code where it's
> appropriate, but I haven't looked into it yet.
> Does the patch look okay?
It looks fine, if it solves this problem and not generate any other I
add it to the new boostbook xsl.