Boost logo

Boost-Build :

Subject: Re: [Boost-build] bjam vs b2
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2013-10-25 15:48:13

On 25 October 2013 18:21, Paul A. Bristow <pbristow_at_[hidden]> wrote:
>> Mateusz Loskot [mailto:mateusz_at_[hidden]]:
>> The BBv2 reference
>> (
>> 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
>> (
>> "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?
> Fine by me - but "bjam is now b2" is still needed somewhere (for those who knew what bjam was but haven't met b2 yet ;-).

Yes and indeed.

So, I've prepared a patch that cleans up the documentation and adds
the missing note:

Hopefully, the BB maintainers will pick it up and review.

Best regards,

Mateusz  Loskot,

Boost-Build list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at