Help: Fix .. versionadded directives in environment variable docs

Many environment variables were documented late and got assigned wrong versions by the script. (The whole Help/envvar section was only added in 3.10). Issue: #19715
2025-12-31 19:00:54 -06:00 · 2020-11-11 00:37:59 +05:00
parent b1208722c5
commit 5934a6275c
28 changed files with 6 additions and 50 deletions
--- a/Help/envvar/ASM_DIALECT.rst
+++ b/Help/envvar/ASM_DIALECT.rst
@@ -1,8 +1,6 @@
 ASM<DIALECT>
 ------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Preferred executable for compiling a specific dialect of assembly language
--- a/Help/envvar/ASM_DIALECTFLAGS.rst
+++ b/Help/envvar/ASM_DIALECTFLAGS.rst
@@ -1,8 +1,6 @@
 ASM<DIALECT>FLAGS
 -----------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Default compilation flags to be used when compiling a specific dialect of an
--- a/Help/envvar/CC.rst
+++ b/Help/envvar/CC.rst
@@ -1,8 +1,6 @@
 CC
 --

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Preferred executable for compiling ``C`` language files. Will only be used by
--- a/Help/envvar/CFLAGS.rst
+++ b/Help/envvar/CFLAGS.rst
@@ -1,8 +1,6 @@
 CFLAGS
 ------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Default compilation flags to be used when compiling ``C`` files. Will only be
--- a/Help/envvar/CMAKE_CONFIG_TYPE.rst
+++ b/Help/envvar/CMAKE_CONFIG_TYPE.rst
@@ -1,8 +1,6 @@
 CMAKE_CONFIG_TYPE
 -----------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 The default build configuration for :ref:`Build Tool Mode` and
--- a/Help/envvar/CMAKE_MSVCIDE_RUN_PATH.rst
+++ b/Help/envvar/CMAKE_MSVCIDE_RUN_PATH.rst
@@ -1,8 +1,6 @@
 CMAKE_MSVCIDE_RUN_PATH
 ----------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Extra PATH locations for custom commands when using
--- a/Help/envvar/CMAKE_OSX_ARCHITECTURES.rst
+++ b/Help/envvar/CMAKE_OSX_ARCHITECTURES.rst
@@ -1,8 +1,6 @@
 CMAKE_OSX_ARCHITECTURES
 -----------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Target specific architectures for macOS.
--- a/Help/envvar/CMAKE_PREFIX_PATH.rst
+++ b/Help/envvar/CMAKE_PREFIX_PATH.rst
@@ -1,8 +1,6 @@
 CMAKE_PREFIX_PATH
 -----------------

-.. versionadded:: 3.18
-
 .. include:: ENV_VAR.txt

 The ``CMAKE_PREFIX_PATH`` environment variable may be set to a list of
--- a/Help/envvar/CSFLAGS.rst
+++ b/Help/envvar/CSFLAGS.rst
@@ -1,7 +1,7 @@
 CSFLAGS
 -------

-.. versionadded:: 3.10
+.. versionadded:: 3.9.2

 .. include:: ENV_VAR.txt

--- a/Help/envvar/CTEST_INTERACTIVE_DEBUG_MODE.rst
+++ b/Help/envvar/CTEST_INTERACTIVE_DEBUG_MODE.rst
@@ -1,8 +1,6 @@
 CTEST_INTERACTIVE_DEBUG_MODE
 ----------------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Environment variable that will exist and be set to ``1`` when a test executed
--- a/Help/envvar/CTEST_OUTPUT_ON_FAILURE.rst
+++ b/Help/envvar/CTEST_OUTPUT_ON_FAILURE.rst
@@ -1,8 +1,6 @@
 CTEST_OUTPUT_ON_FAILURE
 -----------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Boolean environment variable that controls if the output should be logged for
--- a/Help/envvar/CTEST_PARALLEL_LEVEL.rst
+++ b/Help/envvar/CTEST_PARALLEL_LEVEL.rst
@@ -1,8 +1,6 @@
 CTEST_PARALLEL_LEVEL
 --------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Specify the number of tests for CTest to run in parallel. See :manual:`ctest(1)`
--- a/Help/envvar/CTEST_USE_LAUNCHERS_DEFAULT.rst
+++ b/Help/envvar/CTEST_USE_LAUNCHERS_DEFAULT.rst
@@ -1,8 +1,6 @@
 CTEST_USE_LAUNCHERS_DEFAULT
 ---------------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Initializes the :variable:`CTEST_USE_LAUNCHERS` variable if not already defined.
--- a/Help/envvar/CUDACXX.rst
+++ b/Help/envvar/CUDACXX.rst
@@ -1,7 +1,7 @@
 CUDACXX
 -------

-.. versionadded:: 3.10
+.. versionadded:: 3.8

 .. include:: ENV_VAR.txt

--- a/Help/envvar/CUDAFLAGS.rst
+++ b/Help/envvar/CUDAFLAGS.rst
@@ -1,7 +1,7 @@
 CUDAFLAGS
 ---------

-.. versionadded:: 3.10
+.. versionadded:: 3.8

 .. include:: ENV_VAR.txt

--- a/Help/envvar/CUDAHOSTCXX.rst
+++ b/Help/envvar/CUDAHOSTCXX.rst
@@ -1,7 +1,7 @@
 CUDAHOSTCXX
 -----------

-.. versionadded:: 3.10
+.. versionadded:: 3.8

 .. include:: ENV_VAR.txt

--- a/Help/envvar/CXX.rst
+++ b/Help/envvar/CXX.rst
@@ -1,8 +1,6 @@
 CXX
 ---

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Preferred executable for compiling ``CXX`` language files. Will only be used by
--- a/Help/envvar/CXXFLAGS.rst
+++ b/Help/envvar/CXXFLAGS.rst
@@ -1,8 +1,6 @@
 CXXFLAGS
 --------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Default compilation flags to be used when compiling ``CXX`` (C++) files. Will
--- a/Help/envvar/DASHBOARD_TEST_FROM_CTEST.rst
+++ b/Help/envvar/DASHBOARD_TEST_FROM_CTEST.rst
@@ -1,8 +1,6 @@
 DASHBOARD_TEST_FROM_CTEST
 -------------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Environment variable that will exist when a test executed by :manual:`ctest(1)`
--- a/Help/envvar/DESTDIR.rst
+++ b/Help/envvar/DESTDIR.rst
@@ -1,8 +1,6 @@
 DESTDIR
 -------

-.. versionadded:: 3.12
-
 .. include:: ENV_VAR.txt

 On UNIX one can use the ``DESTDIR`` mechanism in order to relocate the
--- a/Help/envvar/FC.rst
+++ b/Help/envvar/FC.rst
@@ -1,8 +1,6 @@
 FC
 --

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Preferred executable for compiling ``Fortran`` language files. Will only be used
--- a/Help/envvar/FFLAGS.rst
+++ b/Help/envvar/FFLAGS.rst
@@ -1,8 +1,6 @@
 FFLAGS
 ------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Default compilation flags to be used when compiling ``Fortran`` files. Will only
--- a/Help/envvar/LDFLAGS.rst
+++ b/Help/envvar/LDFLAGS.rst
@@ -1,8 +1,6 @@
 LDFLAGS
 -------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Will only be used by CMake on the first configuration to determine the default
--- a/Help/envvar/MACOSX_DEPLOYMENT_TARGET.rst
+++ b/Help/envvar/MACOSX_DEPLOYMENT_TARGET.rst
@@ -1,8 +1,6 @@
 MACOSX_DEPLOYMENT_TARGET
 ------------------------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Specify the minimum version of macOS on which the target binaries are
--- a/Help/envvar/PackageName_ROOT.rst
+++ b/Help/envvar/PackageName_ROOT.rst
@@ -1,7 +1,7 @@
 <PackageName>_ROOT
 ------------------

-.. versionadded:: 3.12.1
+.. versionadded:: 3.12

 .. include:: ENV_VAR.txt

--- a/Help/envvar/RC.rst
+++ b/Help/envvar/RC.rst
@@ -1,8 +1,6 @@
 RC
 --

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Preferred executable for compiling ``resource`` files. Will only be used by CMake
--- a/Help/envvar/RCFLAGS.rst
+++ b/Help/envvar/RCFLAGS.rst
@@ -1,8 +1,6 @@
 RCFLAGS
 -------

-.. versionadded:: 3.10
-
 .. include:: ENV_VAR.txt

 Default compilation flags to be used when compiling ``resource`` files. Will
--- a/Help/variable/PackageName_ROOT.rst
+++ b/Help/variable/PackageName_ROOT.rst
@@ -1,7 +1,7 @@
 <PackageName>_ROOT
 ------------------

-.. versionadded:: 3.12.1
+.. versionadded:: 3.12

 Calls to :command:`find_package(<PackageName>)` will search in prefixes
 specified by the ``<PackageName>_ROOT`` CMake variable, where