Merge pull request SCons#4483 from mwichmann/doc/msvc-version

Update MSVC_VERSION usage and table

Author: bdbaddog

CHANGES.txt

@@ -95,6 +95,9 @@ RELEASE  VERSION/DATE TO BE FILLED IN LATER
       would fail with an exception if called with a module which is
       not found.  It will now return None.  Updated manpage entry and
       docstring..
+    - Doc update: standardized on the use of a new entity &MSVC; to
+      describe the Microsoft C++ compiler. Update the version table slightly.
+      Amplified the usage of MSVC_VERSION.
     - Improve SharedLibrary docs a bit.
 
 

SCons/Platform/Platform.xml

@@ -167,7 +167,7 @@ else:
     </para>
     <para>
       On the <literal>win32</literal> platform,
-      if the Microsoft Visual C++ compiler is available,
+      if the &MSVC; compiler is available,
       &t-link-msvc; tool setup is done using
       &cv-HOST_ARCH; and &cv-link-TARGET_ARCH;.
       Changing the values at any later time will not cause
@@ -196,7 +196,7 @@ else:
     </para>
     <para>
       On the <literal>win32</literal> platform,
-      if the Microsoft Visual C++ compiler is available,
+      if the &MSVC; compiler is available,
       &t-link-msvc; tool setup is done using
       &cv-link-HOST_ARCH; and &cv-TARGET_ARCH;.
       If a value is not specified,
@@ -323,7 +323,7 @@ and
 <para>
 The prefix for the name of the temporary file used
 to store command lines exceeding &cv-link-MAXLINELENGTH;.
-The default prefix is <literal>'@'</literal>, which works for the Microsoft
+The default prefix is <literal>'@'</literal>, which works for the &MSVC;
 and GNU toolchains on Windows.
 Set this appropriately for other toolchains,
 for example <literal>'-@'</literal> for the diab compiler

SCons/Tool/mslink.xml

@@ -85,9 +85,9 @@ when using Microsoft Visual Studio.
 <cvar name="PDB">
 <summary>
 <para>
-The Microsoft Visual C++ PDB file that will store debugging information for
+The &MSVC; PDB file that will store debugging information for
 object files, shared libraries, and programs. This variable is ignored by
-tools other than Microsoft Visual C++.
+tools other than &MSVC;.
 When this variable is
 defined SCons will add options to the compiler and linker command line to
 cause them to generate external debugging information, and will also set up the
@@ -100,7 +100,7 @@ env['PDB'] = 'hello.pdb'
 </example_commands>
 
 <para>
-The Visual C++ compiler switch that SCons uses by default
+The &MSVC; compiler switch that SCons uses by default
 to generate PDB information is <option>/Z7</option>.
 This works correctly with parallel (<option>-j</option>) builds
 because it embeds the debug information in the intermediate object files,
@@ -238,7 +238,7 @@ and must be supplied by the developer.
 If set to true,
 &scons;
 will add the manifest file
-generated by Microsoft Visual C++ 8.0 and later
+generated by &MSVC; 8.0 and later
 to the target list so &SCons; will be aware they
 were generated.
 In the case of an executable, the manifest file name
@@ -294,7 +294,7 @@ Defaults to <filename>.exp</filename>.
 <summary>
 <para>
 The prefix used for executable program manifest files
-generated by Microsoft Visual C/C++.
+generated by &MSVC;.
 Defaults to empty.
 </para>
 </summary>
@@ -304,7 +304,7 @@ Defaults to empty.
 <summary>
 <para>
 The suffix used for executable program manifest files
-generated by Microsoft Visual C/C++.
+generated by &MSVC;.
 Defaults to <filename>.manifest</filename>.
 </para>
 </summary>
@@ -314,7 +314,7 @@ Defaults to <filename>.manifest</filename>.
 <summary>
 <para>
 The prefix used for shared library manifest files
-generated by Microsoft Visual C/C++.
+generated by &MSVC;.
 Defaults to empty.
 </para>
 </summary>
@@ -324,7 +324,7 @@ Defaults to empty.
 <summary>
 <para>
 The suffix used for shared library manifest files
-generated by Microsoft Visual C/C++.
+generated by &MSVC;.
 Defaults to <filename>.manifest</filename>.
 </para>
 </summary>