Boost C++ Libraries: Ticket #1280: sections in imported source files get put inside <para> elements in docbook output https://svn.boost.org/trac10/ticket/1280 <p> I've noticed that if you have a quickbook file which just imports a bunch of headers and expands their templates (the [section]s are all in the header comments), then quickbook decides to put all the sections inside a &lt;para&gt; element. This prevents docbook from doing any chunking of the html output. Also, a &lt;section&gt; is not permitted to be a child of a &lt;para&gt; in docbook. </p> <p> Attached is a minimal example project that demonstrates the bug. It includes a file section_in_para.xml which is the intermediate docbook file that was generated when I built, and which has a &lt;section&gt; inside a &lt;para&gt;. </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/1280 Trac 1.4.3 Frank Mori Hess Mon, 24 Sep 2007 19:07:33 GMT attachment set https://svn.boost.org/trac10/ticket/1280 https://svn.boost.org/trac10/ticket/1280 <ul> <li><strong>attachment</strong> → <span class="trac-field-new">section_in_para.tgz</span> </li> </ul> <p> Example project showing bug </p> Ticket Frank Mori Hess Mon, 24 Sep 2007 19:09:59 GMT component changed; owner set https://svn.boost.org/trac10/ticket/1280#comment:1 https://svn.boost.org/trac10/ticket/1280#comment:1 <ul> <li><strong>owner</strong> set to <span class="trac-author">Joel de Guzman</span> </li> <li><strong>component</strong> <span class="trac-field-old">None</span> → <span class="trac-field-new">quickbook</span> </li> </ul> Ticket Daniel James Sun, 06 Jun 2010 06:30:45 GMT status changed; resolution set https://svn.boost.org/trac10/ticket/1280#comment:2 https://svn.boost.org/trac10/ticket/1280#comment:2 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">duplicate</span> </li> </ul> <p> Import works by creating templates for the code blocks, which is where the problem lies. I'm going to try to fix this soon-ish, and I've created a new ticket (<a class="closed ticket" href="https://svn.boost.org/trac10/ticket/4302" title="#4302: Bugs: Templates are always expanded inside paragraphs (closed: fixed)">#4302</a>) for the problem. Not really a 'duplicate' since that's a new ticket. </p> Ticket