Re: [jamboost] [BBv2] Building BJam wiki documentation update

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-07-05 11:54:59

Rene Rivera wrote:
> Andrey Melnikov wrote:
> 
>>Rene Rivera wrote:
>>
>>>Where is the jam_src/index.html information duplicated?
>>
>>http://www.boost.org/tools/build/jam_src/index.html#building_bjam
>>http://www.boost.org/tools/build/v1/build_system.htm#installing_jam
>>http://www.boost.org/more/getting_started.html#step2
> 
> I don't see duplication... AFAICT (2) and (3) both point you to (1) on 
> how to build bjam. But perhaps that's not clear?

Each this document contains SOME of the documentation. None of them are 
full. And it's hard to find all 3 documents because they are in 
different places: some things are described only in bjam documentation, 
some only in bbv1 doc, and some only in Boost doc. Also all these 
documents are outdated and (1) is cluttered with information not related 
to building. And I actually had problems discovering all these 
documentation pieces. It doesn't look clear at all.

>>I like the idea of having both brief "Howto" documentation and full 
>>"Reference" documentation. But 3 sets of documentation in 3 different 
>>places are confusing. Also "Howto" should have the most important and 
>>frequently used information from "Reference". Now all 3 "refences" are 
>>incomplete, each page contains information other pages don't. At least 
>>we should add more structure.
> 
> Well that Howto is getting rewritten by Hendrik, see the "Customer 
> Friendlier Boost Installation" thread on the Boost dev list. And 
> v1/build_system.htm will eventually go away to be replaced by the BBv2 
> documentation.

It seems I drowned in the volume of boost dev list, and missed recent 
additions to that thread completely. Now I'm catching up. I hope my 
recent additions to Wiki (related purely to bbv2) will help Hendrik in 
his work.

Andrey