Re: BoostBook problem

From: David Abrahams (gclbb-jamboost_at_[hidden])
Date: 2003-08-29 08:20:33

Vladimir Prus <ghost_at_[hidden]> writes:

> The boostbook support still gives me troubles.
>
> 1. If no boostbook xsl is found, "errors.error" is invoked. I think this is 
> wrong. Some time ago "msvc" used to produce error but was changed to warning 
> on user request. Rationale was: a project might use msvc and might use 
> boostbook, and for example, it can specify <toolset>msvc:<optimization>off, 
> just like it can specify default documentation format for BoostBook. 
> Naturally, the project should contain "using boostbook ;". But the developers 
> who don't have msvc, or boostbook installed, should not see error on "using".
>
> The won't be able to use boostbook, and warning about it is OK, but there's no 
> reason for them to change anything just to compile stuff.
>
> 2. The check is never executed, actually. If nothing is found, "path.make" 
> will be called without argument, and die.
>
> 3. I am not sure that adding "using boostbook ; " to user-config.jam is right 
> thing. After all, most users don't have docbook, or xsltproc and a warning 
> should be emited. But those ordinary users don't care about doc, and will be 
> probably suprised by warning about tools they don't know about. Maybe, those 
> who use BoostBook can be asked to uncomment relevant lines?

Why is there a user-config.jam in our CVS in the first place, other
than as an example which has no effect? This is *supposed* to be set
up by the user in her home directory, isnt' it?

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com