Re: [boost] BOOST documentation in PDF/PS format

From: John Maddock (jz.maddock_at_[hidden])
Date: 2008-06-03 13:03:12

Daniel James wrote:
>>  Actually there *may* be a solution to the
>>  wrongly-keeping-long-blocks-together issue: insert a "<?dbfo
>>  keep-together="auto" ?>" inside the Docbook XML for the long block,
>>  that should then allow it to page break and stop it from starting a
>>  new page. The problem is while I think I can see how to insert this
>>  into quickbook, I can't see how to insert this into your ref.xml at
>> present :-(
>
> I tried adding it to the synopses in the boostbook xsl, but it didn't
> seem to make much difference. The change to the xsl is at:
>
> http://svn.boost.org/trac/boost/changeset/46060
>
> If we could get this to work I could try to develop something a bit
> more sophisticated.

Unfortunately having now looked a bit deeper it appears that dbfo
keep-together instructions aren't processed by verbatim blocks :-(

Indeed, because the keep-together instruction is placed in an attribute set
and just injected "as is" into the fo:block by the verbatim processing xsl
there appears to be not much we can do :-(

I'll see if I can a docbook XSL mailing list to ask about this as it would
be nice to have this solved.

John.