Paul A Bristow wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Vladimir Prus Sent: 24 October 2007 12:05 To: boost@lists.boost.org 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_... 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