Boost logo

Boost-Build :

From: Jeremy Siek (jsiek_at_[hidden])
Date: 2004-01-29 11:18:50


Hi Vladimir,

The main point I'd like to make is that when it comes to bjam docs,
it would be nice if priority would be given to documenting those
features that are used the most by the end user (in this case,
the boost developer, not a bjam developer). The current docs
are full of interesting information about features that the average
boost developer will never use, but are lacking in documentation
for the basic features that one finds in every Jamfile.

--- In jamboost_at_[hidden], Vladimir Prus <ghost_at_c...> wrote:
> Hi Jeremy,
>
> >> B. Version 2 has been getting ready to replace version 1 for a
long
> >> time now :(, and we don't want to waste time documenting
version 1
> >

Besides, it is so much more fun to write code than to write
documentation :)

> > How big are the differences between v1 and v2 from the user (boost
> > developer)
> > point of view?
>
> You can decide for yourself, for example by taking look at
>
> libs/graph/test/Jamfile
>
> and
>
> libs/graph/test/Jamfile.v2

Good, it looks like there is a lot of similarity.

> At least for testing, all the rules ('compile', 'run') has the same
interface
> in V2 as in V1.

Great!

> Hmm... despite all said above I can hardly have time to expand docs
for V2
> testing system. The primary V2 docs issue for now is extender's
manual and
> even that does not progress as quickly as I'd like.

I'm not familiar with this "extender's manual". What is it?

Cheers,
Jeremy

------------------------------------------------------------------------
-----------------
Jeremy Siek http://php.indiana.edu/~jsiek/
Ph.D. Student, Indiana Univ. B'ton email: jsiek_at_[hidden]
C++ Booster (http://www.boost.org) office phone: (812) 856-1820
------------------------------------------------------------------------
-----------------

 


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