Re: [jamboost] Re: [BBv2 docs editorial] Installation

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-09-22 06:43:37

David Abrahams wrote:
> David Abrahams <dave_at_[hidden]> writes:
> 
> 
>>Vladimir Prus <ghost_at_[hidden]> writes:
>>
>>
>>>On Wednesday 21 September 2005 05:17, Andrey Melnikov wrote:
>>>
>>>>See http://tinyurl.com/aaf5e . I implemented all the changes suggested
>>>>by you and me.
>>>
>>>Looks fine for me. Except that we don't have prebuilt Solaris binary, as far 
>>>as I can tell.
>>>
>>>Is this version fine with everybody?
>>
>>No, phrasing like this is going to make people think we're sadists:
>>
>> If your platform isn't in the list, or if you downloaded the
>> latest Boost beta sources from CVS instead of an official Boost
>> release, installation guide describes how to compile bjam from
>> sources located in tools/build/jam_src or jam_src by running
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> build.bat or build.sh.
>> ^^^^^^^^^^^^^^^^^^^^^
> 
> 
> I'm sorry; that probably sounded harsh. It wasn't intended to be.
> 

I agree with you. This phrase was taken from the previous discussion. 
Actually the discussion was over due to flames from my side and no one 
commented on it.

The original purpose of this paragraph was to give user a hint so most 
users won't need to read the doc.

If the general idea is good, what about this:

-------
If your platform isn't in the list, or if you downloaded the
latest Boost beta sources from CVS instead of an official Boost
release, you need to locate jam_src folder and run build.bat on Windows 
or build.sh on *nix. If bjam executable isn't built, see detailed 
instructions in Installation Guide.
--------

Andrey