Re: [Boost-docs] Docbook to html optimizations

Subject: Re: [Boost-docs] Docbook to html optimizations
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-03-23 09:23:39

 -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Steven Watanabe
> Sent: Saturday, March 20, 2010 8:38 PM
> To: Discussion of Boost Documentation
> Subject: [Boost-docs] Docbook to html optimizations
> 
> AMDG
> 
> The attached patch speeds up the final generation of html output from over an hour to about 20 minutes.
> Most the changes are overriding slow docbook templates, since all of the bottlenecks were in the docbook stylesheets.

I've installed your patches into my copy of trunk (so I think I'm using it?)

> This is very much a work in progress, but do others see similar improvements?  I'm using the most recent versions of
the tools, xsltproc 1.1.26 and docbook-xsl-1.75.2.

Not using these yet? docbook-xsl-1.74.0

C:\Program Files\xsltproc_win32>xsltproc.exe --version
Using libxml 20630, libxslt 10122 and libexslt 813
xsltproc was compiled against libxml 20630, libxslt 10122 and libexslt 813
libxslt 10122 was compiled against libxml 20630
libexslt 813 was compiled against libxml 20630

Do I really need these new versions?

ftp://ftp.zlatkovic.com/libxml/ offer some Nov 2009 versions - use these?  or?

I've rebuilt units and maths and SVGplot library in sandbox OK.

But in another example (where I've just added some suggested extra parameters for the logo),

I get a failure with message (caused by recent suggested <xsl:param>boost.image=Boost ... ;-)

"too many params increase MAX_PARAMETERS"
xslt-xsltproc ..\bin.v2\doc\msvc-9.0\debug\auto-index-on\threading-multi\quick_auto_dox_index.docbook

too many params increase MAX_PARAMETERS

    set XML_CATALOG_FILES=..\bin.v2/boostbook_catalog.xml
<snipped>
...failed xslt-xsltproc ..\bin.v2\doc\msvc-9.0\debug\auto-index-on\threading-multi\quick_auto_dox_index.docbook...

(Seems to be 32 - I've removed a few possibly unnecessary and it works OK ).
How/can do I increase it? - it seems to be a #define in some C code?

html looks OK but pdf ends with 

fop.render.pdf
I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\doc\..\bin.v2\doc\msvc-9.0\debug\auto-index-on\thr
eading-multi\quick_auto_dox_index.modified.pdf
(document [system-id
file:/I:/boost-sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index/doc/../bin.v2/doc/msvc-9.0/debug/auto-index-
on/threading-multi/quick_auto_dox_index.modified.fo]
  (validate 
    [error] There can be only one 'rx:outline' element as a child of 'fo:root'.
    [validation total: 1 error]
Parse error: Invalid XSL FO source
'file:/I:/boost-sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index/doc/../bin.v2/doc/msvc-9.0/debug/auto-index
-on/threading-multi/quick_auto_dox_index.modified.fo': 1 error found during validation

I this a mistake I've made? 

More Thanks

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal, UK   LA8 8AB
[phone], mobile [phone]
pbristow_at_[hidden]