Re: [boost] [fusion] html docs woes

Subject: Re: [boost] [fusion] html docs woes
From: Joel de Guzman (joel_at_[hidden])
Date: 2011-07-20 01:20:21

On 7/20/2011 11:30 AM, Eric Niebler wrote:
> On 7/19/2011 6:43 PM, Joel de Guzman wrote:
>> On 7/19/2011 10:51 PM, Dave Abrahams wrote:
>>> I appreciate the trade-offs, but IMO in the long run checking in
>>> generated artifacts usually hurts more than it helps.
>>
>> Thanks for your input, Dave.
>>
>> We haven't had problems and as noted, quickbook now eliminates spurious
>> diffs in generated html. What exactly do you mean by "usually hurts
>> more than it helps". How will it hurt? What are we missing?
> 
> Just today, you committed a change to the fusion/doc/sequence.qbk
> without the corresponding changes to the HTML. (Because we were
> discussing it, maybe?)

Yes.

>   https://svn.boost.org/trac/boost/changeset/73247
> 
> 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. The vast majority of those diffs are
> spurious, such as:
> 
>   -<a name="id857416"></a><p>
>   +<a name="id843910"></a><p>
> 
> and
> 
>   -<td align="left"><p><small>Last revised: July 08, 2011 at 18:14:46
> GMT</small></p></td>
>   +<td align="left"><p><small>Last revised: July 20, 2011 at 03:18:49
> GMT</small></p></td>
> 
> Can you tell me why I'm getting so many diffs? AFAIK, I'm using an
> up-to-date quickbook.exe.

If that's the case, then that is clearly unacceptable. I was under the
impression that this has been fixed? Daniel? Hartmut? John?

Regards,
-- 
Joel de Guzman
http://www.boostpro.com
http://boost-spirit.com