Run the script: Utilities/Sphinx/update_versions.py --since v4.1.0 --overwrite
@@ -1,6 +1,8 @@
CMAKE_FASTBUILD_VERBOSE_GENERATOR
---------------------------------
+.. versionadded:: 4.2
+
.. include:: include/ENV_VAR.rst
The ``CMAKE_FASTBUILD_VERBOSE_GENERATOR`` environment variable specifies a custom default
FASTBuild
=========
Generates a ``fbuild.bff`` file, which can be used to build the project with
`FASTBuild <https://www.fastbuild.org/docs/home.html>`_.
JOB_POOL_COMPILE
----------------
Ninja only: Pool used for compiling.
The number of parallel compile processes could be limited by defining
CMAKE_FASTBUILD_ALLOW_RESPONSE_FILE
-----------------------------------
Enables FASTBuild's ``AllowResponseFile`` option.
See the `FASTBuild Compiler() documentation <https://www.fastbuild.org/docs/functions/compiler.html>`_
CMAKE_FASTBUILD_CACHE_PATH
--------------------------
Specifies the directory for the FASTBuild artifact cache in the generated file.
If not set, FASTBuild will use the ``FASTBUILD_CACHE_PATH`` environment
CMAKE_FASTBUILD_CAPTURE_SYSTEM_ENV
----------------------------------
Controls capturing of the system environment into ``fbuild.bff``.
Setting it to ``OFF`` makes the invocation of all tools (compilers and other external processes) hermetic.
CMAKE_FASTBUILD_CLANG_GCC_UPDATE_XLANG_ARG
------------------------------------------
Enables FASTBuild's ``ClangGCCUpdateXLanguageArg`` option.
CMAKE_FASTBUILD_CLANG_REWRITE_INCLUDES
--------------------------------------
Enables FASTBuild's ``ClangRewriteIncludes`` option.
CMAKE_FASTBUILD_COMPILER_EXTRA_FILES
-------------------------------------
Specifies a semicolon-separated list of additional files (usually DLLs) to
include in the FASTBuild ``Compiler()`` node.
CMAKE_FASTBUILD_ENV_OVERRIDES
-----------------------------
Allows overriding environment variables in the captured environment written to
``fbuild.bff``.
CMAKE_FASTBUILD_FORCE_RESPONSE_FILE
Enables FASTBuild's ``ForceResponseFile`` option.
CMAKE_FASTBUILD_SOURCE_MAPPING
------------------------------
Sets FASTBuild's ``SourceMapping_Experimental`` option.
Example:
CMAKE_FASTBUILD_TRACK_BYPRODUCTS_AS_OUTPUT
By default, custom commands declaring only ``BYPRODUCTS`` will always
run unconditionally.
You can use this variable to make FASTBuild rerun the command only when its
CMAKE_FASTBUILD_USE_DETERMINISTIC_PATHS
---------------------------------------
Enables FASTBuild's ``UseDeterministicPaths_Experimental`` option.
CMAKE_FASTBUILD_USE_LIGHTCACHE
-------------------------------
Enables FASTBuild’s *light caching* mode, which accelerates cache lookups by
parsing source files directly (instead of invoking the compiler preprocessor).
CMAKE_FASTBUILD_USE_RELATIVE_PATHS
Enables FASTBuild's ``UseRelativePaths_Experimental`` option.
Enables verbose logging during FASTBuild file generation.
Initialized by the :envvar:`CMAKE_FASTBUILD_VERBOSE_GENERATOR`