Subject: Re: [boost] [fusion] html docs woes
From: Joel de Guzman (joel_at_[hidden])
Date: 2011-07-19 21:43:39
On 7/19/2011 10:51 PM, Dave Abrahams wrote:
> on Mon Jul 18 2011, Joel de Guzman <joel-AT-boost-consulting.com> wrote:
>> For the record, I'm still unsure about which procedure to follow,
>> but I'm glad to know that there are other reasonable solutions.
>> I still dislike having to regen the docs when I am offline. While
>> it is true that Eric says it's just a bjam away, well, it's still
>> a bjam away. Often, I am in the middle of something and I need to
>> know a function or typedef or something. Having to bjam and wait for
>> the regen to finish just to get that crucial info gets in the way
>> of the thought-flow. OTOH, I'm mostly online anyway. And, you can always
>> have the full release at hand, with all the docs; -- unless of course
>> when you need something new from the trunk.
>> There's always a tradeoff, if anyone else out there cares about this,
>> then please share your voice for the sake of consensus.
> 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?
-- Joel de Guzman http://www.boostpro.com http://boost-spirit.com
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk