Re: [jamboost] V2 Wiki

From: Toon Knapen (toon.knapen_at_[hidden])
Date: 2004-10-12 05:56:38

Vladimir Prus wrote:
> 
> I've created a V2-specific page on the Boost Wiki. The address is
> 
> http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Build_V2
> 
> The idea is that all users can easily add howtos, and comments there. The 
> relevant material will be periodically moved to the main documentation.
> The V2 home page is also updated with the link to Wiki.

I've added already soth. to the wiki. First I added a small section on 
compiling bjam (which is not IMO in the bjamv2 documentation)

Next I am for a long time already hungry for some kind of reference.
1) A reference on the bjam-language.
The bjam language IMO is not very well documented and it would be nice 
to see some kind of reference of all
_ control flow constructs that can be used in bjam (if-else),
_ what the builtin datatypes are (lists)
_ and how they can be manipulated (what is the difference between 
'list+' and 'list*'),
_ what the function calling convention is
_ and are rules similar to functions ..

Probably all this information can be found in some Perforce Jam 
documents. And if there are perforce jam documents that describe this, 
is this still valid for bjam syntax? If there are such documents and it 
would be good to summerise them on our wiki I would be more than happy 
to do that.

2) and a reference on BoostBuild rules that can be used
Similar to the Jambase.html in the perforce-jam documentation but then 
targeted to the boost-build audience.

If others would be interested in documentation as described above and/or 
like what I've started on the wiki let me know (so that I know that I'm 
not the only one that has a hard time tracking all features of bjam and 
boost-build and annoyed to have to ask Vladimir always to get to the 
answer;-)

toon