diff --git a/Help/variable/MSVC.rst b/Help/variable/MSVC.rst
index 913ed080cabb63dbba0e41a2d96745ddb9678d06..22a087a778159e536c6f70a2f3ee9e09a7affc31 100644
--- a/Help/variable/MSVC.rst
+++ b/Help/variable/MSVC.rst
@@ -4,3 +4,5 @@ MSVC
 ``True`` when using Microsoft Visual C++.
 
 Set to ``true`` when the compiler is some version of Microsoft Visual C++.
+
+See also the :variable:`MSVC_VERSION` variable.
diff --git a/Help/variable/MSVC10.rst b/Help/variable/MSVC10.rst
index 98e0493d3e16ea273cc5c10d15a38cc4eac381e9..55c63371f3af4d97bd6594d7261d1a87ddb2f8f3 100644
--- a/Help/variable/MSVC10.rst
+++ b/Help/variable/MSVC10.rst
@@ -1,5 +1,7 @@
 MSVC10
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v100`` toolset
 (``cl`` version 16) or another compiler that simulates it.
diff --git a/Help/variable/MSVC11.rst b/Help/variable/MSVC11.rst
index 42b7b866a675ec9f2f1066f311f7e33734d75794..17943dcc455957886735e69c4e416eccebb4efba 100644
--- a/Help/variable/MSVC11.rst
+++ b/Help/variable/MSVC11.rst
@@ -1,5 +1,7 @@
 MSVC11
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v110`` toolset
 (``cl`` version 17) or another compiler that simulates it.
diff --git a/Help/variable/MSVC12.rst b/Help/variable/MSVC12.rst
index 0648f351a2f53038d58a4ac05b5cfb3deda2a0d6..a524fab3b02b077259a8fd864c02bb7d21bd8f20 100644
--- a/Help/variable/MSVC12.rst
+++ b/Help/variable/MSVC12.rst
@@ -1,5 +1,7 @@
 MSVC12
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v120`` toolset
 (``cl`` version 18) or another compiler that simulates it.
diff --git a/Help/variable/MSVC14.rst b/Help/variable/MSVC14.rst
index 16bfe07836718a13fbe76bf6a394c45969868d33..79e0c10b58af0a339165451a72cab348c0460231 100644
--- a/Help/variable/MSVC14.rst
+++ b/Help/variable/MSVC14.rst
@@ -1,5 +1,7 @@
 MSVC14
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v140`` or ``v141``
 toolset (``cl`` version 19) or another compiler that simulates it.
diff --git a/Help/variable/MSVC60.rst b/Help/variable/MSVC60.rst
index 14f09cfadb5dea959685406fd2d57a05ee47fa76..14164bf76a1855096bd2ba9149ee10a23ffed616 100644
--- a/Help/variable/MSVC60.rst
+++ b/Help/variable/MSVC60.rst
@@ -1,6 +1,8 @@
 MSVC60
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using Microsoft Visual C++ 6.0.
 
 Set to ``true`` when the compiler is version 6.0 of Microsoft Visual C++.
diff --git a/Help/variable/MSVC70.rst b/Help/variable/MSVC70.rst
index 76fa96fa9a2c62a2b35440475e776fbb1c93fb82..ed3b0bbdfac03e194d0d6091b270ebe784fb2ba4 100644
--- a/Help/variable/MSVC70.rst
+++ b/Help/variable/MSVC70.rst
@@ -1,6 +1,8 @@
 MSVC70
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using Microsoft Visual C++ 7.0.
 
 Set to ``true`` when the compiler is version 7.0 of Microsoft Visual C++.
diff --git a/Help/variable/MSVC71.rst b/Help/variable/MSVC71.rst
index d69d4fc10fc3b6d3a591e514a8fe9622d747e0a4..0237592c6192293a6513b558b76446c253456e21 100644
--- a/Help/variable/MSVC71.rst
+++ b/Help/variable/MSVC71.rst
@@ -1,6 +1,8 @@
 MSVC71
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using Microsoft Visual C++ 7.1.
 
 Set to ``true`` when the compiler is version 7.1 of Microsoft Visual C++.
diff --git a/Help/variable/MSVC80.rst b/Help/variable/MSVC80.rst
index 0d33e826aa64611aa09c438903015a791042fbce..1533218a93eb7eb37dc044e3436ffa726f4aa4ad 100644
--- a/Help/variable/MSVC80.rst
+++ b/Help/variable/MSVC80.rst
@@ -1,5 +1,7 @@
 MSVC80
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v80`` toolset
 (``cl`` version 14) or another compiler that simulates it.
diff --git a/Help/variable/MSVC90.rst b/Help/variable/MSVC90.rst
index 1716e6f3f53114f5716d60c01303ed92e591784b..4981ecff0565c1457931015b72550d5928037397 100644
--- a/Help/variable/MSVC90.rst
+++ b/Help/variable/MSVC90.rst
@@ -1,5 +1,7 @@
 MSVC90
 ------
 
+Discouraged.  Use the :variable:`MSVC_VERSION` variable instead.
+
 ``True`` when using the Microsoft Visual Studio ``v90`` toolset
 (``cl`` version 15) or another compiler that simulates it.