Re: Improving Boost Build?

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.co
m/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.

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost-build

On 5/16/07, John Maddock <johnjohnmaddock.co.uk>
wrote:
> Dean Michael Berris wrote:
> >
> > 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.co
m/cgi-bin/boost_wiki/wiki.pl?InstallingBoost
> so do feel free to dig in and start editing ! 
>

Sweet! I'll get at it as soon as I can. 

> 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) :-(
>

Yeah... But if we can somehow export the Wiki pages into RST
files,
then maybe we might be able to do something about that.

-- 
Dean Michael C. Berris
http://cplusplus-
soup.blogspot.com/
mikhailberis AT gmail DOT com
+63 928 7291459
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost-build