Boost logo

Boost :

Subject: Re: [boost] [fusion] html docs woes
From: Eric Niebler (eric_at_[hidden])
Date: 2011-07-20 16:30:22

On 7/19/2011 10:58 PM, Daniel James wrote:
> On 20 July 2011 06:20, Joel de Guzman <joel_at_[hidden]> wrote:
>> On 7/20/2011 11:30 AM, Eric Niebler wrote:
>>> So I just generated the new Fusion HTML docs and did an svn diff. The
>>> resulting diff file is 1,617 lines, and is too large for me to post
>>> here, weighing in at 112K.
> [snip]
>> If that's the case, then that is clearly unacceptable. I was under the
>> impression that this has been fixed? Daniel? Hartmut? John?
> Not fixed, but improved. In a previous check-in (r72930) the svn diff
> of the generated html was 872K.
> The improvement was acheived by adding ids to headings in quickbook,
> because if they don't have them docbook generates random ids for them.
> There are still ids generated for some things. I had a look at recent
> changes to the spirit documentation and fixed a couple of them the
> other day (on legalnotice and footnotes). Looking at the fusion
> documentation there also seem to be a few for tables, which I can
> probably fix. But I don't think I can completely fix this, certainly
> not for anyone using a boostbook generated reference.
> The last revised dates are generated by quickbook. It'd be quite easy
> to add a flag to suppress them. I don't like them much anyway, since
> they tend to be misleading.

Joel, would you accept a patch to remove the generated HTML docs and
integrate Fusion docs into the regular Boost doc build?

Eric Niebler
BoostPro Computing

Boost list run by bdawes at, gregod at, cpdaniel at, john at