[Boost-build] bug: rule syntax shows no arglist (was Re: Question about SHELL command

From: Larry Evans (cppljevans_at_[hidden])
Date: 2007-08-04 22:19:10

On 08/03/2007 01:15 AM, Rene Rivera wrote:
[snip]
> And also...
> 
> http://www.boost.org/doc/html/jam/language.html#jam.language.rules

This is inconsistent because it includes, at:

http://www.boost.org/doc/html/jam/language.html#jam.language.rules

the rule syntax (which is missing the arg list):

   rule rulename { statements }

and also, at:

http://www.boost.org/doc/html/jam/language.html#jam.language.rules.argument_lists

the rule instance (which *has* the arg list):

   rule report ( pronoun index ? : state : names + )

of course you could *define* the rulename as being composed of the "rule 
identifier" followed by ( arglist ) ; however, this is not what the 
casual reader would expect.  Shouldn't this be changed to accommodate
such a casual reader?