Merged revisions 1907-1940,1942-1967 via svnmerge from

http://scons.tigris.org/svn/scons/branches/core

........
  r1914 | stevenknight | 2007-05-19 20:18:45 -0700 (Sat, 19 May 2007) | 4 lines

  Use the dict() builtin, not a by-hand function, to assemble --debug=explain
  info.  Update our backwards-compatibility dict() function so its calling
  signature matches the later SCons dict() builtin, and so it actually works.
........
  r1920 | stevenknight | 2007-05-21 19:59:00 -0700 (Mon, 21 May 2007) | 4 lines

  Issue 1652:  only add the {base}_p.c and {base}_data.c files if the
  /proxy or /dlldata arguments are present (respectively).
  (Allan Erskine)
........
  r1921 | stevenknight | 2007-05-21 20:09:54 -0700 (Mon, 21 May 2007) | 2 lines

  Add initial .svnt/conf file for experimental use.
........
  r1924 | stevenknight | 2007-05-22 17:51:34 -0700 (Tue, 22 May 2007) | 3 lines

  Don't let tool initialization overwrite ${C,CXX}FILESUFFIX if they're
  already set.
........
  r1925 | stevenknight | 2007-05-22 19:14:27 -0700 (Tue, 22 May 2007) | 3 lines

  Change the --debug=explain message when AlwaysBuild() is set from
  the default "unknown reasons" to "because AlwaysBuild() is specified."
........
  r1927 | stevenknight | 2007-05-23 05:20:32 -0700 (Wed, 23 May 2007) | 3 lines

  Issue 1658:  Find Java anonymous classes when the next token after
  the name is an open parenthesis.  (Jan Nijtmans)
........
  r1928 | stevenknight | 2007-05-23 11:50:20 -0700 (Wed, 23 May 2007) | 3 lines

  Issue 1313:  add support for {Get,Set}Option('help') and
  {Get,Set}Option('random') .
........
  r1929 | stevenknight | 2007-05-23 11:56:18 -0700 (Wed, 23 May 2007) | 3 lines

  Issue 1362:  Push/retrieve built symlinks to/from a CacheDir() as symlinks,
  not by copying file contents.
........
  r1930 | stevenknight | 2007-05-23 12:55:12 -0700 (Wed, 23 May 2007) | 3 lines

  Issue 1638:  add LaTeX scanner support for finding dependencies from
  \usepackage{} directives.  (Sohail Somani)
........
  r1932 | stevenknight | 2007-05-24 05:06:45 -0700 (Thu, 24 May 2007) | 3 lines

  Add a section mentioning that libraries can be built from mixed lists
  of source code and object files.  (Follow-up from IRC chat.)
........
  r1933 | stevenknight | 2007-05-24 11:18:30 -0700 (Thu, 24 May 2007) | 2 lines

  Issue 1467:  add /opt/SUNWspro/bin to the default execution $PATH on Solaris.
........
  r1934 | stevenknight | 2007-05-24 13:10:01 -0700 (Thu, 24 May 2007) | 3 lines

  Support running tests when Python is in a path that contains
  spaces (like "C:\Program Files\Python...").
........
  r1935 | stevenknight | 2007-05-24 13:11:52 -0700 (Thu, 24 May 2007) | 4 lines

  Issue 1479:  print multiple projects in a Visual Studio 7.[01] solution
  file, generating a separate GUID for each instead of re-using the
  solution GUID.  (Mark Bertoglio)
........
  r1937 | stevenknight | 2007-05-26 14:35:17 -0700 (Sat, 26 May 2007) | 4 lines

  Issue 1659:  when stringifying a generator action, fall back to using
  the default construction environment, not an empty dictionary, if not
  environment was supplied.
........
  r1938 | stevenknight | 2007-05-29 05:14:37 -0700 (Tue, 29 May 2007) | 2 lines

  Re-run tests if any of the test infrastructure changed, too.
........
  r1940 | stevenknight | 2007-05-29 06:58:42 -0700 (Tue, 29 May 2007) | 2 lines

  Issue 1634:  "define HAVE_FEATURE 1" lines in generated config.h files.
........
  r1943 | stevenknight | 2007-05-29 13:24:34 -0700 (Tue, 29 May 2007) | 2 lines

  Issue 1426:  Generalize AlwaysBuild() to non-File Nodes.
........
  r1945 | stevenknight | 2007-05-30 08:15:25 -0700 (Wed, 30 May 2007) | 3 lines

  Clean up emitter unit tests:  subdivide one large test case into
  separate tests, code renaming and reorganizing for readability.
........
  r1947 | stevenknight | 2007-05-30 10:22:49 -0700 (Wed, 30 May 2007) | 4 lines

  Issue 1656:  two PDB fixes:
  1)  support expansion of $TARGET, etc. in emitted file names
  2)  put the output PDB file in the target's build_dir
........
  r1951 | stevenknight | 2007-05-31 12:51:42 -0700 (Thu, 31 May 2007) | 3 lines

  Refactor the checkLogAndStdout() function into a TestSCons method
  so we can split the sub-tests into their own scripts.
........
  r1952 | stevenknight | 2007-05-31 13:00:56 -0700 (Thu, 31 May 2007) | 3 lines

  Also move the definition of what system library we need to use for
  Configure tests into the TestSCons class.
........
  r1953 | stevenknight | 2007-05-31 14:12:16 -0700 (Thu, 31 May 2007) | 2 lines

  Refactor the Configure context subtests into separate scripts.
........
  r1954 | stevenknight | 2007-05-31 14:18:11 -0700 (Thu, 31 May 2007) | 3 lines

  Get rid of the work_dir argument to checkLogAndStdout(), since we're
  no longer executing sub-tests from separate subdirectories.
........
  r1955 | stevenknight | 2007-05-31 14:35:20 -0700 (Thu, 31 May 2007) | 2 lines

  Move the test to its correct subdirectory.  Oops.
........
  r1958 | stevenknight | 2007-06-01 08:35:50 -0700 (Fri, 01 Jun 2007) | 2 lines

  Skip the Visual C/C++ PDB + BuildDir test when not run on Windows.
........
  r1959 | stevenknight | 2007-06-01 09:35:09 -0700 (Fri, 01 Jun 2007) | 2 lines

  Support an AddMethod() global function and construction environment method.
........
  r1960 | stevenknight | 2007-06-01 09:52:59 -0700 (Fri, 01 Jun 2007) | 3 lines

  Python 1.5 compatibility in the test infrastructure added to support
  the refactored Configure tests.
........
  r1963 | stevenknight | 2007-06-01 12:29:48 -0700 (Fri, 01 Jun 2007) | 2 lines

  Python 1.5 compatibility fix for AddMethod().
........

1 files changed, 59 insertions, 3 deletions

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index 73e3df9..c0b91ec 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -1975,6 +1975,59 @@ until the Action object is actually used.
 
 '\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .TP 
+.RI AddMethod( object, function ", [" name ])
+.TP
+.RI env.AddMethod( function ", [" name ])
+When called with the
+.BR AddMethod ()
+form,
+adds the specified
+.I function
+to the specified
+.I object
+as the specified method
+.IR name .
+When called with the
+.BR env.AddMethod ()
+form,
+adds the specified
+.I function
+to the construction environment
+.I env
+as the specified method
+.IR name .
+In both cases, if
+.I name
+is omitted or
+.BR None ,
+the name of the
+specified
+.I function
+itself is used for the method name.
+
+.ES
+# Note that the first argument to the function to
+# be attached as a method must be the object through
+# which the method will be called; the Python
+# convention is to call it 'self'.
+def my_method(self, arg):
+    print "my_method() got", arg
+
+# Use the global AddMethod() function to add a method
+# to the Environment class.  This
+AddMethod(Environment, my_method)
+env = Environment()
+env.my_method('arg')
+
+# Add the function as a method, using the function
+# name for the method call.
+env = Environment()
+env.AddMethod(my_method, 'other_method_name')
+env.other_method_name('another arg')
+.EE
+
+'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.TP 
 .RI AddPostAction( target ", " action )
 .TP
 .RI env.AddPostAction( target ", " action )
@@ -4048,16 +4101,19 @@ if not env.has_key('FOO'): env['FOO'] = 'foo'
 This function provides a way to set a select subset of the scons command
 line options from a SConscript file. The options supported are:
 .B clean
-which corresponds to -c, --clean, and --remove;
+which corresponds to -c, --clean and --remove;
 .B duplicate
-which 
-corresponds to --duplicate;
+which corresponds to --duplicate;
+.B help
+which corresponds to -h and --help;
 .B implicit_cache
 which corresponds to --implicit-cache;
 .B max_drift
 which corresponds to --max-drift;
 .B num_jobs
 which corresponds to -j and --jobs.
+.B random
+which corresponds to --random.
 See the documentation for the
 corresponding command line object for information about each specific
 option. Example: