Re: [boost] on quickbook/docbook etc

From: Vladimir Prus (ghost_at_[hidden])
Date: 2007-10-24 07:37:48

Paul A Bristow wrote:

>  
> 
>>-----Original Message-----
>>From: boost-bounces_at_[hidden]
>>[mailto:boost-bounces_at_[hidden]] On Behalf Of Vladimir Prus
>>Sent: 24 October 2007 12:05
>>To: boost_at_[hidden]
>>Subject: Re: [boost] on quickbook/docbook etc
>  
>>> *Please* can we have a comment warning about this - and the
>>bizarre 'you
>>> need spaces' syntax.
>>> 
>>> I'm sure this simple addition would avoid a big load of
>>grief - there's a
>>> lot of it about where bjam is involved.
>>
>>Comment where? user-config.jam, or boost-build docs or getting started?
> 
> In every jam file!!!

Well, I would expect that before changing random jam file, the person
changing it would at least glance docs about syntax. Which happen
to mention the 'spaces' issues right away, with big red sign:

        http://boost.org/boost-build2/doc/html/bbv2/advanced.html#bbv2.advanced.jam_language

user-config.jam is special in that it's necessary to edit it even if you don't want
to use boost.build proper, so I've just added various comments to 
tools/build/v2/user-config.jam

Would you check if that's better?

> Well - at the very least user-config.jam,
> 
> and preferably boost-build docs

The spaces issue is already documented. I have an action item to clarify '\' issue.

> and getting started too ;-) 

I'm not sure that's good idea -- it would be better to refer to boost.build docs.

- Volodya