Re: [jamboost] Problem with --help

From: Rene Rivera (grafik666_at_[hidden])
Date: 2002-09-12 16:57:15

By the way I just got the error you pointed out with --help-all earlier
fixed. Putting it in a few minutes...

[2002-09-12] David Abrahams wrote:

>Hi Rene,
>
>I was just trying out the help system again, and ran into another problem.
>I have edited the comments in the feature module. When I try
>bjam --help-feature.subfeature I get:
>....found 3 targets...
>
>feature.subfeature looks like:
>
># Declares a subfeature
>rule subfeature (
> feature # Root feature that is not a subfeature
> value-string ? # A value-string specifying which feature or
> # subfeature values this subfeature is specific to,
> # if any
>
> : subfeature # The name of the subfeature being declared
> : subvalues * # The allowed values of this subfeature
> : attributes * # The attributes of the subfeature
>)
>{
> feature = [ grist $(feature) ] ;
> validate-feature $(feature) ;
> if $(subfeature) in $($(feature).subfeatures)
> {
> error \"$(subfeature)\" already declared as a subfeature of
>\"$(feature)\" ;
> }
> $(feature).subfeatures += $(subfeature) ;
> extend-subfeature $(feature) $(value-string) : $(subfeature) :
>$(subvalues) ;
> local f = [ utility.ungrist $(feature) ] ;
> feature $(f)-$(subfeature) : $(subvalues) : $(attributes) ;
>}

Hmm, not good, perhaps the #<NL> #<NL> is not getting handled corretly. Is
this the only place where that's used?

>Also, two requests:
>
>1. Could we allow the syntax: "bjam --help feature.subfeature" ?

Don't know if the "bjam" parsing of args will let me do that, but I'll try.

>2. Could you /not/ output help for local rules (e.g.
>feature.validate-value-string)? Those are generally not part of the public
>interface.

It's on my TODO list ;-) And it's now possibly without loosing functionality
because I have help options implemented. So I can make displaying of local
rules an option (defaulting to no).

-- grafik - Don't Assume Anything
-- rrivera_at_[hidden] - grafik_at_[hidden]
-- 102708583_at_icq - Grafik666_at_AIM - Grafik_at_[hidden]