Re: [Boost-build] BBv2 documentation

From: Rene Rivera (grafik.list_at_[hidden])
Date: 2005-11-13 15:56:56

Reece Dunn wrote:
> Jared W. Robinson wrote:
> 
>>Second, BJam is a descendant of Jam. BJam is poorly documented in
>>comparison, so it's important to understand Jam. The best, and most
>>effective way, IMHO, to get started is to read
>>http://www.perforce.com/perforce/conf2001/wingerd/WPLaura.pdf
>>followed by using http://public.perforce.com/public/jam/src/Jam.html as
>>a reference.
> 
> See boost/tools/build/jam_src/Jam.html.

Also, <http://www.boost.org/tools/build/jam_src/index.html> describes the bjam 
extensions. I'm personally planning on rewriting both of those into one set of 
docs, in QuickBook, so that it can be directly integrated into the rest of the 
Boost and BBv2 docs.

> There is also a lot of information spread out all over the place (BBv2 
> docs, Wiki, Boost/Getting Started, jam_src/index.html, etc.) that should 
> be in one place (this is part of the confusion).

But we have to be careful how we put those together because at some point it 
starts looking scary for beginners to encounter a large document just to build 
Boost.

> Also, the BBv2 
> documentation is difficult to access (www.boost.org -> Getting Started 
> (Preparation) -> Boost.Build -> Boost.Build2 -> Documentation).

Well it's also available from <http://www.boost.org/doc/html/>. But I'm 
failing to find a link to that any place obvious.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com - 102708583/icq