Re: [Boost-build] Documentation toolchain, ease of use

Subject: Re: [Boost-build] Documentation toolchain, ease of use
From: Daniel James (dnljms_at_[hidden])
Date: 2011-02-05 09:53:37

On 4 February 2011 21:49, Steven Watanabe <watanabesj_at_[hidden]> wrote:
> Okay, so here are the proposed semantics
> in detail.
> * All parameters are optional
> * The value of each parameter is the last value given in
>  any call to using.
> * The tool is not initialized at all unless
>  there is a using statement somewhere.  It
>  must be initialized before the first use.
> * If a parameter is never specified, it will
>  be deduced in some appropriate default manner.
> * Any attempt to explicitly set a parameter
>  after the tool has been "used", results
>  in a hard error, where the exact meaning of
>  "used" is defined by the tool.

That seems good to me.

By the way, if you look in 'fop.jam' there's some code that tries to
use absolute paths for the arguments so that the fop command can be
run from its own directory (the code to do that is commented out) but
it uses GLOB to get the path which only works if the file already
exists. I didn't know how to fix it, so I left it alone. I suspect
this was a workaround for an issue that has since been fixed in fop so
it's probably okay to remove it.

thanks,

Daniel