bug: rule syntax shows no arglist (was Re: Question about SHELL command

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

This is inconsistent because it includes, at:

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

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

   rule rulename 

and also, at:

http://www.boost.org/doc/html/j
am/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?

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost-build

On 08/04/2007 09:19 PM, Larry Evans wrote:
> On 08/03/2007 01:15 AM, Rene Rivera wrote:
> [snip]
>> And also...
>>
>> http://www.boost.org/doc/html/jam/language.htm
l#jam.language.rules
> 
> This is inconsistent because it includes, at:
> 
> http://www.boost.org/doc/html/jam/language.htm
l#jam.language.rules
> 
> the rule syntax (which is missing the arg list):
> 
>    rule rulename 
> 
[snip]

This .html file apparently is produced from:

   boost/tools/jam/doc/bjam.qbk

applying the following diff would solve the problem
(although I haven't actually tried it):

*** bjam.qbk	2007/08/05 12:48:23	1.1
--- bjam.qbk	2007/08/05 12:52:14
***************
*** 521,527 ****
   Define a rule's procedure, replacing any previous
definition.

   [pre
! rule /rulename/ { /statements/ }
   ]

   Define a rule's updating actions, replacing any previous
definition.
--- 521,527 ----
   Define a rule's procedure, replacing any previous
definition.

   [pre
! rule /rulename/ ( /param1/ : /param2/ : /.../ : /paramN/ )
{ 
/statements/ }
   ]

   Define a rule's updating actions, replacing any previous
definition.

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost-build