Updated NEXT_RELEASE->4.10.0. Regenerated doc generated doc files

Author: bdbaddog

CHANGES.txt

@@ -10,10 +10,7 @@ NOTE: Since SCons 4.3.0, Python 3.6.0 or above is required.
 NOTE: Since SCons 4.9.0, Python 3.7.0 or above is required.
 
 
-RELEASE  VERSION/DATE TO BE FILLED IN LATER
-
-  From John Doe:
-    - Whatever John Doe did.
+RELEASE 4.10.0 -  Thu, 02 Oct 2025 11:40:20 -0700
 
   From Joseph Brill:
     - MSVC: A significant delay was experienced in the Github Actions windows

RELEASE.txt

@@ -1,34 +1,13 @@
-If you are reading this in the git repository, the contents
-refer to *unreleased* changes since the last SCons release.
-Past official release announcements appear at:
-
-    https://scons.org/tag/releases.html
-
-==================================================================
-
-A new SCons release, X.Y.Z, is now available on the SCons download page:
+A new SCons release, 4.9.10, is now available on the SCons download page:
 
     https://scons.org/pages/download.html
 
 Here is a summary of the changes since 4.9.1:
 
 
-NEW FUNCTIONALITY
------------------
-
-- List new features (presumably why a checkpoint is being released)
-
-DEPRECATED FUNCTIONALITY
-------------------------
-
-- List anything that's been deprecated since the last release
-
 CHANGED/ENHANCED EXISTING FUNCTIONALITY
 ---------------------------------------
 
-- List modifications to existing features, where the previous behavior
-  wouldn't actually be considered a bug
-
 - Nodes are now treated as PathLike objects.
 
 - Replace use of old conditional expression idioms with the official
@@ -101,10 +80,6 @@ FIXES
 IMPROVEMENTS
 ------------
 
-- List improvements that wouldn't be visible to the user in the
-  documentation:  performance improvements (describe the circumstances
-  under which they would be observed), or major code cleanups
-
 - Virtualenv support module modernized: previously looked first for an
   unofficial approach from before venv support was made part of Python
   in 3.3; now looks for the official approach first. This in an internal
@@ -120,8 +95,6 @@ IMPROVEMENTS
 PACKAGING
 ---------
 
-- List changes in the way SCons is packaged and/or released
-
 - The generated roff (.1) manpages are now included in the
   scons-doc tarball that is built at part of the release process,
   in addition to the html and txt versions. For distribution
@@ -132,10 +105,6 @@ PACKAGING
 DOCUMENTATION
 -------------
 
-- List any significant changes to the documentation (not individual
-  typo fixes, even if they're mentioned in src/CHANGES.txt to give
-  the contributor credit)
-
 - Clarify how pre/post actions on an alias work.
 
 - Improve the description of PackageVariable.
@@ -163,8 +132,6 @@ DOCUMENTATION
 DEVELOPMENT
 -----------
 
-- List visible changes in the way SCons is developed
-
 - runtest.py once again finds "external" tests, such as the tests for
   tools in scons-contrib. An earlier rework had broken this.  Fixes #4699.
 

SCons/Environment.py

@@ -1304,7 +1304,7 @@ def __getattr__(self, name):
         other parts of SCons depend on seeing the :exc:`AttributeError` that
         triggers this call, so all we do is produce our own message.
 
-        .. versionadded:: NEXT_RELEASE
+        .. versionadded:: 4.10.0
         """
         raise AttributeError(
             f"Builder or other environment method {name!r} not found.\n"

SCons/Executor.py

@@ -204,7 +204,7 @@ def get_lvars(self):
     def _get_changes(self) -> None:
         """Populate all the changed/unchanged lists.
 
-        .. versionchanged:: NEXT_RELEASE
+        .. versionchanged:: 4.10.0
            ``_changed_sources``, ``_changed_targets``, ``_unchanged_sources``
            and ``_unchanged_targets`` are no longer separate instance
            attributes, but rather saved in the :attr:`_memo` dict.

SCons/Platform/Platform.xml

@@ -459,7 +459,7 @@ be represented in the 7-bit ASCII characer set),
 set this variable to the appropriate codec.
 See also &cv-link-TEMPFILEDIR;.
 </para>
-<para><emphasis>New in version NEXT_RELEASE</emphasis></para>
+<para><emphasis>New in version 4.10.0</emphasis></para>
 </summary>
 </cvar>
 

SCons/Script/__init__.py

@@ -235,7 +235,7 @@ def _Remove_Argument(aarg: str) -> None:
     could not recognize it belongs to an option and is not a standalone
     variable=value argument.
 
-    .. versionadded:: NEXT_RELEASE
+    .. versionadded:: 4.10.0
 
     """
     if aarg:
@@ -261,7 +261,7 @@ def _Remove_Target(targ: str) -> None:
     Since we are "correcting an error", we also have to fix up the internal
     :data:`_build_plus_default` list.
 
-    .. versionadded:: NEXT_RELEASE
+    .. versionadded:: 4.10.0
 
     """
     if targ:

doc/generated/builders.gen

@@ -2419,38 +2419,41 @@ when it is done linking it.
 Builds an object file intended for
 inclusion in a shared library.
 Source files must have one of the same set of extensions
-specified above for the
-&b-StaticObject;
+specified for the
+&b-link-StaticObject;
 builder method.
-On some platforms building a shared object requires additional
-compiler option
-(e.g. <option>-fPIC</option> for <command>gcc</command>)
-in addition to those needed to build a
-normal (static) object, but on some platforms there is no difference between a
-shared object and a normal (static) one. When there is a difference, SCons
-will only allow shared objects to be linked into a shared library, and will
-use a different suffix for shared objects. On platforms where there is no
-difference, SCons will allow both normal (static)
-and shared objects to be linked into a
-shared library, and will use the same suffix for shared and normal
-(static) objects.
 The target object file prefix,
 specified by the &cv-link-SHOBJPREFIX; &consvar;
 (by default, the same as &cv-link-OBJPREFIX;),
 and suffix,
 specified by the &cv-link-SHOBJSUFFIX; &consvar;,
 are automatically added to the target if not already present.
+&b-SharedObject; is a single-source builder.
 Examples:
 </para>
 
 <example_commands>
 env.SharedObject(target='ddd', source='ddd.c')
 env.SharedObject(target='eee.o', source='eee.cpp')
 env.SharedObject(target='fff.obj', source='fff.for')
+env.SharedObject(source=Glob('*.c'))
 </example_commands>
 
 <para>
-Note that the source files will be scanned
+On some platforms building a shared object requires additional
+compiler option(s)
+(e.g. <option>-fPIC</option> for <command>gcc</command>)
+in addition to those needed to build a
+normal (static) object.
+If shared and static objects differ,
+&SCons; will allow only shared objects
+to be linked into a shared library,
+and will use a different suffix for shared objects
+to help indicate and track the difference.
+</para>
+
+<para>
+Source files will be scanned
 according to the suffix mappings in the
 <classname>SourceFileScanner</classname>
 object.
@@ -2502,10 +2505,10 @@ will raise an error if there is any mismatch.
     <listitem><para>
 Builds a static object file
 from one or more C, C++, D, or Fortran source files.
-Source files must have one of the following extensions:
+The file extension mapping is shown in the table:
 </para>
 
-<example_commands>
+<literallayout><literal>
   .asm    assembly language file
   .ASM    assembly language file
   .c      C file
@@ -2534,28 +2537,30 @@ Source files must have one of the following extensions:
           POSIX:  assembly language file + C pre-processor
   .spp    assembly language file + C pre-processor
   .SPP    assembly language file + C pre-processor
-</example_commands>
+</literal></literallayout>
 
 <para>
 The target object file prefix,
 specified by the &cv-link-OBJPREFIX; &consvar;
-(nothing by default),
+(empty string by default),
 and suffix,
 specified by the &cv-link-OBJSUFFIX; &consvar;
 (<filename>.obj</filename> on Windows systems,
 <filename>.o</filename> on POSIX systems),
 are automatically added to the target if not already present.
+&b-StaticObject; is a single-source builder.
 Examples:
 </para>
 
 <example_commands>
 env.StaticObject(target='aaa', source='aaa.c')
 env.StaticObject(target='bbb.o', source='bbb.c++')
 env.StaticObject(target='ccc.obj', source='ccc.f')
+env.StaticObject(source=Glob('*.c'))
 </example_commands>
 
 <para>
-Note that the source files will be scanned
+Source files will be scanned
 according to the suffix mappings in the
 <classname>SourceFileScanner</classname>
 object.

doc/generated/examples/builderswriting_ex2_1.xml

@@ -1,5 +1,9 @@
 <screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0 http://www.scons.org/dbxsd/v1.0/scons.xsd">% <userinput>scons -Q</userinput>
-AttributeError: 'SConsEnvironment' object has no attribute 'Program':
+AttributeError: Builder or other environment method 'Program' not found.
+Check spelling, check external program exists in env['ENV']['PATH'],
+and check that a suitable tool is being loaded:
   File "/home/my/project/SConstruct", line 7:
     env.Program('hello.c')
+  File "SCons/Environment.py", line 1309:
+    raise AttributeError(
 </screen>

doc/generated/examples/caching_ex-random_1.xml

@@ -1,7 +1,7 @@
 <screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0 http://www.scons.org/dbxsd/v1.0/scons.xsd">% <userinput>scons -Q</userinput>
+cc -o f5.o -c f5.c
 cc -o f4.o -c f4.c
 cc -o f1.o -c f1.c
-cc -o f5.o -c f5.c
 cc -o f3.o -c f3.c
 cc -o f2.o -c f2.c
 cc -o prog f1.o f2.o f3.o f4.o f5.o

doc/generated/examples/troubleshoot_Dump_2.xml

@@ -13,7 +13,7 @@ scons: Reading SConscript files ...
   'CCDEPFLAGS': '/showIncludes',
   'CCFLAGS': ['/nologo'],
   'CCPCHFLAGS': <function gen_ccpchflags at 0x700000>,
-  'CCPDBFLAGS': ['${(PDB and "/Z7") or ""}'],
+  'CCPDBFLAGS': ['${"/Z7" if PDB else ""}'],
   'CFILESUFFIX': '.c',
   'CFLAGS': [],
   'CONFIGUREDIR': '#/.sconf_temp',
@@ -74,7 +74,7 @@ scons: Reading SConscript files ...
   'PCHCOM': '$CXX /Fo${TARGETS[1]} $CXXFLAGS $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS '
             '$_CPPINCFLAGS /c $SOURCES /Yc$PCHSTOP /Fp${TARGETS[0]} '
             '$CCPDBFLAGS $PCHPDBFLAGS',
-  'PCHPDBFLAGS': ['${(PDB and "/Yd") or ""}'],
+  'PCHPDBFLAGS': ['${"/Yd" if PDB else ""}'],
   'PLATFORM': 'win32',
   'PROGPREFIX': '',
   'PROGSUFFIX': '.exe',