Bart wrote:
I discovered a problem with the documentation build system.
When I run `bjam --v2 doc fo` from the $BOOST_ROOT/doc directory, it
generates some *.boostbook files in the bin.v2 directory.
Here's a snippet from one of those files:
<template-type-parameter name="RangeT"/>
</template><parameter
name="Output"><paramtype>OutputIteratorT</paramtype><description><para>An
output iterator to which the result will be copied
</para></description></parameter><parameter
name="Input"><paramtype>const RangeT
&</paramtype><description><para>An input range
</para></description></parameter><parameter
name="Loc"><paramtype>const std::locale
&</paramtype><default>std::locale()</default><description><para>A
locale used for conversion
</para></description></parameter></signature><signature><type>SequenceT</type><template>
Notice the backwards 'template' tags?
Html can still be built with this problem present, but not pdf.
I had a look at the string algo .boostbook file, and I found similar
XML, but it doesn't look malformed to me. It only looks wrong because
the part you're showing doesn't contain matching tags. I see:
<template>
<template-type-parameter name="OutputIteratorT"/>
<template-type-parameter name="RangeT"/>
</template>
<parameter name="Output">
<paramtype>OutputIteratorT</paramtype>
<description>
<para>
An output iterator to which the result will be copied
</para>
</description>
</parameter>
<parameter name="Input">
<paramtype>const RangeT &</paramtype>
<description><para>An input range</para></description>
</parameter>
<parameter name="Loc">
<paramtype>const std::locale &</paramtype>
<default>std::locale()</default>
<description><para>A locale used for conversion</para></description>
</parameter>
Which is perfectly OK.
So you should back up and tell me exactly what it is you're trying to
do. Are you trying to generate the date_time pdf? If so, then all you
need to do is type "bjam --v2 pdf" from the date_time/xmldoc directory
after applying my Jamfile.v2 patch.
If you're trying to build a PDF from $BOOST_ROOT/doc, I don't think it
has ever worked, but that's a FOP bug, not a BoostBook bug.
Perhaps you could also tell me where it's failing for you and what the
error message is. What you have shown me so far is not indicative of any
problem at all.
I don't know what "bjam --v2 doc fo" does, but when I do this, it
completes successfully for me, and I end up with a 13 Mb boost.fo.
Perhaps it's a problem with your version of docbook-xsl or fop? I'm using:
docbook-xsl-1.65.1
docutils-0.3.7
doxygen-1.3.7
fop-0.20.5
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
