Problem with --help

From: David Abrahams (dave_at_[hidden])
Date: 2002-09-12 16:16:47

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) ;
}

Also, two requests:

1. Could we allow the syntax: "bjam --help feature.subfeature" ?
2. Could you /not/ output help for local rules (e.g.
feature.validate-value-string)? Those are generally not part of the public
interface.

Thanks,
Dave

-----------------------------------------------------------
David Abrahams * Boost Consulting
dave_at_[hidden] * http://www.boost-consulting.com