Re: [Boost-build] [WIKI Entry] - How to run Boost Build standalone

From: Johan Nilsson (r.johan.nilsson_at_[hidden])
Date: 2007-09-05 03:37:58

Peter Foley wrote:
> Roland,
>
> Thanks for the feedback.  (Comments inline.)
>
>> From: Roland Schwarz <roland.schwarz_at_[hidden]>
>>
>> Sorry to tell you, but I see a couple of things:
>>
>> 1) bjam _is_ _not_ boost build, so the phrase:
>>     BJAM - Is a synonym within this document for Boost.Build.
>>     has the potential to confuse users.
>
> Could you please explain what is wrong with the statement?  Obviously
> I
> am confused myself then =p.

There's a history of previous confusion between the BJam and Boost.Build 
concepts. Even if you clearly define that this definition is only used 
within the document's scope, it could lead to further confusion because of 
people starting to use 'bjam' as a synonym to 'Boost.Build'.

It's sort of like saying "GCC - Is a synonym within this document for the 
Boost.C++ libraries". You're using one already existing definition as an 
alias for another.

>
> Would it make more sense to change the heading of this section to
> "Definitions used in this document"?

The heading is not the problem.

/ Johan