Re: [Boost-docs] Docbook to html optimizations

Subject: Re: [Boost-docs] Docbook to html optimizations
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2010-03-21 18:28:09

AMDG

Resending this to the list...

Daniel James wrote:
> On 20 March 2010 20:38, Steven Watanabe <watanabesj_at_[hidden]> wrote:
>   
>> Most the changes are overriding slow docbook templates,
>> since all of the bottlenecks were in the docbook stylesheets.
>>
>> 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.
>>     
>
> I haven't done any timings but it certainly feels faster. I've
> compared it to the documentation generated for trunk. It seems to be
> mostly the same but it generates different previous page links in some
> places. I think yours are actually more sensible. For an example:
>
> http://www.boost.org/doc/libs/1_42_0/doc/html/boost/CV/constrained_value.html
>
> On this page the next arrow links to 'simple_exception_policy', on
> that, next links to a nested struct
> 'simple_exception_policy::exception_wrapper'. Previous on this page
> links back to 'constrained_value' - two pages earlier. Your version
> links to 'simple_exception_policy' which makes more sense to me.
>   

This is probably caused by using the chunkfast.xsl stylesheet
instead of chunk.xsl.  I'll look into it.  If the stylesheets are
indeed producing different links, it should probably be
reported to the docbook people.

In Christ,
Steven Watanabe