Add msvc script error global policy and construction variable. Move msvc not found policy and msvc script error policy to Policy.py. Rework vcvars bugfix handling for SxS toolset 14.28. Add method to return msvc toolsets. Add experimental function to return msvc version and msvc toolset version given a version specification (proxy for selection). Add API.py to manage symbols imported in vc.py. Update documentation.

1 files changed, 25 insertions, 5 deletions

diff --git a/CHANGES.txt b/CHANGES.txt
index 381b061..a4cf13a 100755
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -76,19 +76,39 @@ RELEASE  VERSION/DATE TO BE FILLED IN LATER
       present, there is no easy way to detect during msvc initialization if the default environment
       will be used later to build a program and/or library. There is no error/warning issued for the
       default tools as there are legitimate SCons uses that do not require a c compiler.
-    - Added a global policy setting and an environment policy variable for specifying the action to
-      be taken when an msvc request cannot be satisfied. The available options are "error",
+    - Added a global policy setting and an environment construction variable for specifying the
+      action to be taken when an msvc request cannot be satisfied. The available options are "error",
       "exception", "warning", "warn", "ignore", and "suppress".  The global policy variable may be
       set and retrieved via the functions set_msvc_notfound_policy and get_msvc_notfound_policy,
-      respectively.  These two methods may be imported from SCons.Tool.MSCommon.  The environment
-      policy variable introduced is MSVC_NOTFOUND_POLICY.  When defined, the environment policy
+      respectively.  These two methods may be imported from SCons.Tool.MSCommon.vc. The environment
+      construction variable is MSVC_NOTFOUND_POLICY.  When defined, the environment construction
       variable overrides the global policy setting for a given environment. When the active policy
       is "error" or "exception", an MSVCVersionNotFound exception is raised.  When the active policy
-      is "warning" or "warn", a VisualCMissingWarning warning is issued and the constructed
+      is "warning" or "warn", an MSVCVersionNotFoundWarning warning is issued and the constructed
       environment is likely incomplete. When the active policy is "ignore" or "suppress", no action
       is taken and the constructed environment is likely incomplete.  As implemented, the default
       global policy is "warning".  The ability to set the global policy via an SCons command-line
       option may be added in a future enhancement.
+    - Added a global policy setting and an environment construction variable for specifying the
+      action to be taken when msvc script errors are detected. The available options are "error",
+      "exception", "warning", "warn", "ignore", and "suppress".  The global policy variable may be
+      set and retrieved via the functions set_msvc_scripterror_policy and get_msvc_scripterror_policy,
+      respectively.  These two methods may be imported from SCons.Tool.MSCommon.vc. The environment
+      construction variable is MSVC_SCRIPTERROR_POLICY.  When defined, the environment construction
+      variable overrides the global policy setting for a given environment. When the active policy
+      is "error" or "exception", an MSVCScriptExecutionError exception is raised when msvc batch file
+      errors are detected.  When the active policy is "warning" or "warn", an MSVCScriptExecutionWarning
+      warning is issued when msvc batch file errors are detected. When the active policy is "ignore" or
+      "suppress", msvc batch error messages are suppressed.  As implemented, the default global policy
+      is "ignore".  The ability to set the global policy via an SCons command-line option may be added
+      in a future enhancement.
+    - Experimental: added function find_msvc_version_toolset to SCons.Tool.MSCommon.vc. Given a version
+      specification, this function will return a msvc version and a toolset version.  The toolset version
+      may be None.  The msvc version and toolset version can be used in the environment construction
+      variables MSVC_VERSION and MSVC_TOOLSET_VERSION, respectively.  The version specification may be an
+      msvc version or an msvc toolset version. This is an experimental proxy for using a toolset version
+      to perform instance selection.  This function may be removed when toolset version is taken into
+      account during msvc instance selection.
 
   From William Deegan:
     - Fix check for unsupported Python version. It was broken. Also now the error message