[Boost-build] [docs]multiple tokened formal args not documented properly

From: Larry Evans (cppljevans_at_[hidden])
Date: 2007-09-12 08:33:25

The page:

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

contains:

   Each name in a list of formal arguments (separated by ":" in the rule
   declaration) is bound to a single element of the corresponding actual
   argument unless followed by one of these modifiers:

however, the example on same page:

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

contains apparently 2, not 1, formal argument names (i.e. pronoun and
index) which are bound to *subparts* of the 1st actual argument.  Of 
course if you define "name" as "1 or more white space delimited tokens"
then the first name would be "pronoun index" and the above sentence
would be true; however, that's not the natural interpretation of "name";
hence, I believe this sentence should be modified to account for
multiple formal argument names being bound to subparts of the actual
argument.