[Boost-build] actions bind doc slightly confusion and what variables available in actions?

From: Larry Evans (cppljevans_at_[hidden])
Date: 2007-08-03 14:23:08

* question 1:

WebPage:
 
http://boost.org/boost-build2/doc/html/jam/language.html#jam.language.rules.builtins.modifying_binding

contains:

   actions [ modifiers ] rulename { commands }

but also:

   actions bind vars

a little further down.  The second of these suggest that the 'bind vars' 
doesn't mention where the rulename should be, but I guess one would
assume it follows after the modifiers.  However, this shell command:

cd ~/prog_dev/boost-cvs/ro/boost/tools/build/v2/
find . -name \*.jam -exec grep -e ' bind ' {} \; -ls
actions compile.c++ bind PCH_FILE
actions compile.c bind PCH_FILE
actions link bind LIBRARIES
actions link.dll bind LIBRARIES
6213705   32 -rw-r--r--   1 evansl   evansl      29771 May  5 08:14 
./tools/gcc.jam
actions link bind LIBRARIES
6213714    4 -rw-r--r--   1 evansl   evansl        510 Nov  5  2006 
./tools/kylix.jam

indicates to me that the modifiers *follow* the rulename.

Shouldn't the docs be changes?

* question 2

The following is from gcc.jam:
<-------- cut here ---------
actions link bind LIBRARIES
{
     "$(CONFIG_COMMAND)" -L"$(LINKPATH)" 
-Wl,$(RPATH_OPTION:E=-R)$(SPACE)-Wl,"$(RPATH)" 
-Wl,-rpath-link$(SPACE)-Wl,"$(RPATH_LINK)" -o "$(<)" $(START-GROUP) 
"$(>)" "$(LIBRARIES)" -l$(FINDLIBS-ST) -l$(FINDLIBS-SA) $(END-GROUP) 
$(OPTIONS) $(USER_OPTIONS)
#the above appears all on one line in my editor.
}

 >-------- cut here ---------

What variable values are available in the actions body?  Was the
'bind LIBRARIES' needed because it wasn't among the set of
variables passed to all actions or just actions for link commands
or is there some other criteria for determining the variables
passed to the actions body?