Subject: Re: [Boost-build] bjam vs b2
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2013-10-24 16:55:41
On 10/24/2013 01:36 PM, Mateusz Loskot wrote:
> On 24 October 2013 21:30, Steven Watanabe <watanabesj_at_[hidden]> wrote:
>> On 10/24/2013 10:10 AM, Mateusz Loskot wrote:
>>> 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
>>> Is it OK to fix those by search & replace method?
>> Please check that each one makes sense.
> Makes sense in what...sense?
> That both commands are interchangeable, hence bjam word is a synonim of b2?
Anything describing how to use the tool
should be changed to b2. Historical notes
should use the name that was correct at
the time referred to.
> I look at the two binaries:
> -rwxr-xr-x 1 mloskot users 248640 Oct 24 17:43 b2
> -rwxr-xr-x 1 mloskot users 248640 Oct 24 17:43 bjam
> and it shows me two the same executable programs with different names.
> What the duplicate is for? is an obvious question to me
> and I think it would be good to address it in the documentation,
> even if the reason is: to preserve compatibility with old scripts
> referring to the old name bjam.
That's exactly the reason.
> I haven't found any such note.
> Best regards,
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