Re: [boost] Build doc update

Subject: Re: [boost] Build doc update
From: Eric Niebler (eric_at_[hidden])
Date: 2008-10-16 14:10:42

Vladimir Prus wrote:
> According to:
> 
> 	http://www.boost.org/development/index.html
> 
> we're supposed to have beta release tomorrow, and final release on 31st.
> Are doc changes allowed in between?
> 
> What becomes apparent on IRC, is that the current install docs have issues:
> 
> 	- Boost.Build command line syntax docs are not very good, because
>         they split information across several pages
> 	- Getting started fails to refer to command line syntax directly.
> 	- Getting started lists various variants that may be built, and their
> 	names, but does not give Boost.Build options to request those variants,
> 	so people start to improvise various interesting syntaxes.
> 	- It fails to clearly say that 'configure'/'make' is the approach that's
> 	only good for native, all-default build.
> 
> I think it would be good to clear this up, and can work on this, but of course
> only if the changes can be gotten in. Comments?

I would be OK with this. In fact, more than OK, because I also have doc 
changes I'd like to get in. :-P But I recuse myself and will let Beman 
make the final decision on whether doc changes are allowed after the beta.

-- 
Eric Niebler
BoostPro Computing
http://www.boostpro.com