Commit d93fe90c authored by Craig Scott's avatar Craig Scott Committed by Kitware Robot

Merge topic 'additional_clean_files_help'

e61074c6 Help: Improve ADDITIONAL_CLEAN_FILES documentation
cebccdeb Help: Move ADDITIONAL_MAKE_CLEAN_FILES dir prop to deprecated section
Acked-by: Kitware Robot's avatarKitware Robot <kwrobot@kitware.com>
Merge-request: !3428
parents 0e96fdbc e61074c6
Pipeline #138778 passed with stage
in 0 seconds
......@@ -62,7 +62,6 @@ Properties on Directories
:maxdepth: 1
/prop_dir/ADDITIONAL_CLEAN_FILES
/prop_dir/ADDITIONAL_MAKE_CLEAN_FILES
/prop_dir/BINARY_DIR
/prop_dir/BUILDSYSTEM_TARGETS
/prop_dir/CACHE_VARIABLES
......@@ -505,6 +504,7 @@ Deprecated Properties on Directories
.. toctree::
:maxdepth: 1
/prop_dir/ADDITIONAL_MAKE_CLEAN_FILES
/prop_dir/COMPILE_DEFINITIONS_CONFIG
/prop_dir/TEST_INCLUDE_FILE
......
ADDITIONAL_CLEAN_FILES
----------------------
Additional files to remove during the clean stage.
A :ref:`;-list <CMake Language Lists>` of files or directories that will be
removed as a part of the global ``clean`` target. It is useful for
specifying generated files or directories that are used by multiple targets
or by CMake itself, or that are generated in ways which cannot be captured as
outputs or byproducts of custom commands.
A :ref:`;-list <CMake Language Lists>` of files that will be removed as a
part of the ``clean`` target.
If an additional clean file is specific to a single target only, then the
:prop_tgt:`ADDITIONAL_CLEAN_FILES` target property would usually be a better
choice than this directory property.
Relative paths are allowed and are interpreted relative to the
current binary directory.
Arguments to :prop_dir:`ADDITIONAL_CLEAN_FILES` may use
Contents of ``ADDITIONAL_CLEAN_FILES`` may use
:manual:`generator expressions <cmake-generator-expressions(7)>`.
This property only works for the :generator:`Ninja` and the Makefile
generators. It is ignored on other generators.
generators. It is ignored by other generators.
ADDITIONAL_CLEAN_FILES
----------------------
Additional files to remove during the clean stage.
A :ref:`;-list <CMake Language Lists>` of files or directories that will be
removed as a part of the global ``clean`` target. It can be used to specify
files and directories that are generated as part of building the target or
that are directly associated with the target in some way (e.g. created as a
result of running the target).
A :ref:`;-list <CMake Language Lists>` of files that will be removed as a
part of the ``clean`` target.
For custom targets, if such files can be captured as outputs or byproducts
instead, then that should be preferred over adding them to this property.
If an additional clean file is used by multiple targets or isn't
target-specific, then the :prop_dir:`ADDITIONAL_CLEAN_FILES` directory
property may be the more appropriate property to use.
Relative paths are allowed and are interpreted relative to the
current binary directory.
Arguments to :prop_tgt:`ADDITIONAL_CLEAN_FILES` may use
Contents of ``ADDITIONAL_CLEAN_FILES`` may use
:manual:`generator expressions <cmake-generator-expressions(7)>`.
This property only works for the :generator:`Ninja` and the Makefile
generators. It is ignored on other generators.
generators. It is ignored by other generators.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment