Re: bjam docs foor boost developers?

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: [phone]
------------------------------------------------------------------------ 
-----------------