Re: [Boost-build] ToDo Review Documentation & Building from Subversion Repository

From: Vladimir Prus (ghost_at_[hidden])
Date: 2007-12-01 13:14:25

On Friday 23 November 2007 16:57:39 NJ wrote:
> I'm interested in simultaneously learning Boost Build (V2) and improving the
> documentation.  I've found some minor corrections to make and am
> anticipating more. 

Great!
 
> For the first step, I need to be able to build Boost Build from the
> repository.  I've build it from the tar with build.sh, but haven't found
> the instructions for building the repository version.  It's not in
> hacking.txt.  Would someone point me to the documentation for that or
> describe it for me?

You mean, building Boost.Build? Well, except for that fact that jam
is located in <boost-root>/tools/jam, the instructoins are the same.

> I see that the documentation has its own DTD.  I assume it will be build
> with the rest of Boost Build, but what do I need to install to build the
> documentation?

No, DTD is part of BoostBook, please see http://www.boost.org/doc/html/boostbook.html

> After being able to build the repository version, I would like to make minor
> changes directly to the repository as that is the least overhead method. 
> If you have access control: the only portion of the Subversion repository
> that I am interested in having write access to at this time is for the
> Boost Build documentation.  Is this an appropriate forum to request write
> access? Is there a better?

Generally, we prefer to see a couple of patches before giving commit access.
So, please just post the output of "svn diff" when you have made changes.
When (hopefully) the amount of patches will become too large, I'll ask Boost
moderators to provide you with a commit access.

(BTW, you can use git + git-svn to easily hack locally).

Thanks,
Volodya