Re: [Boost-build] Improving Boost Build?

From: John Maddock (john_at_[hidden])
Date: 2007-05-16 06:33:40

Dean Michael Berris wrote:
>> 2) Better docs.  Yes, I know it's been said before, but we really
>> must get the existing toolsets and their options documented.  This
>> need not take too long if someone would step up and volunteer to do
>> it.
>>
>
> I'd like to help out with this aspect definitely.
>
> The question is, how do we do this in a concerted effort such that we
> can get things moving quickly with the least resistance?
>
> A Wiki would be ideal. Using quickbook for something like this at the
> moment only heightens the barrier to entry because not everyone can go
> ahead and start writing stuff directly with it yet. My only problem
> with a Wiki is that it's hard to export data from there (depending on
> which Wiki we'd choose to use). Previous experience with MoinMoin
> yielded very good results, but I don't think there's a good enough
> "export" feature there just yet.

Well BBv2 already has some Wiki pages here:
http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Build_V2
and while we're at it the installation guide on the Wiki is outdated:
http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?InstallingBoost
so do feel free to dig in and start editing ! :-)

Ultimately though we need to get the documentation inside the main bbv2 
docs: unfortunately these are written in Docbook XML which isn't the easiest 
thing to edit (even if it is "standard" in some sense) :-(

John.