Re: [Boost-build] switching on toolset

Subject: Re: [Boost-build] switching on toolset
From: Robert Ramey (ramey_at_[hidden])
Date: 2015-06-22 13:17:46

On 6/22/15 9:49 AM, Paul A. Bristow wrote:
I have a simple suggestion that I believe would help matter greatly 
without being a major amount of
> work.
>
> Give lots (and lots and lots) more examples of command lines and entries in user-config.jam and
> jamfile.v2.
>
> Add a brief comment on what they do too.
>
> Perhaps you can update the docs source in /develop?
>
> But at least a release update would be really helpful in reducing the user fumbling - and googling
> to lots of often dodgy suggestions.
>
> If you added an example for every query you got, you might head off a lot more queries - and user
> frustration.
>

Here's another idea you might want to try as an experiment

news://gmane.org:119/556A5A63.316.F9C9EB4@s_sourceforge.nedprod.com

The idea is that documentation is annotated by people who have found and 
documentated "special cases" and left notes about them in the documentation.

The best part is that you only have to add some javascript to your 
pages.  If it turns out to be a failure, you can easily back out and 
you're no worse off than you were before.

Robert Ramey