Boost logo

Boost-Build :

Subject: Re: [Boost-build] bjam vs b2
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2013-10-24 16:30:18


AMDG

On 10/24/2013 10:10 AM, Mateusz Loskot wrote:
> Hi,
>
> The BBv2 reference
> (http://www.boost.org/doc/libs/1_54_0/doc/html/bbv2/reference.html)
> mixes the two names what IMO may easily confuse:
>
> "bjam's first job upon startup is to load the Jam code that implements
> the build system."
>
> "In this case, running b2 anywhere..."
>
> The bjam vs b2 is not explained anywhere, neither there is
> "bjam is now b2" step mentioned in the history.qbk.
>
> I noticed one similar 'complain' posted by Paul A. Bristow in 2011
> (http://lists.boost.org/boost-build/2011/07/25216.php)
>
> "I don't feel I've been told about b2 versus bjam?"
>
> Shouldn't the documentation be clearer on bjam vs b2?
> The bjam occurrences in the BBv2 docs are still frequent:
>
> $ cd trunk/tools/build/v2/doc
> $ ack -l -c bjam
> src/extending.xml:3
> src/install.xml:2
> src/reference.xml:1
> src/architecture.xml:8
> src/tasks.xml:1
> history.qbk:23
>
> Is it OK to fix those by search & replace method?
>

Please check that each one makes sense.
In particular, history.qbk should probably
still refer to bjam.

In Christ,
Steven Watanabe


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