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?
> 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
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
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk