Boost logo

Boost :

Subject: Re: [boost] [fusion] html docs woes
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-07-19 10:51:08


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.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com

Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk