diff --git a/Help/manual/cmake-modules.7.rst b/Help/manual/cmake-modules.7.rst index e108bc34b9..17c1a1e5c3 100644 --- a/Help/manual/cmake-modules.7.rst +++ b/Help/manual/cmake-modules.7.rst @@ -15,7 +15,6 @@ These modules are loaded using the :command:`include` command. .. toctree:: :maxdepth: 1 - /module/AddFileDependencies /module/AndroidTestUtilities /module/BundleUtilities /module/CheckCCompilerFlag @@ -272,6 +271,7 @@ Deprecated Utility Modules .. toctree:: :maxdepth: 1 + /module/AddFileDependencies /module/CMakeDetermineVSServicePack /module/CMakeExpandImportedTargets /module/CMakeForceCompiler diff --git a/Help/release/dev/AddFileDependencies-deprecate.rst b/Help/release/dev/AddFileDependencies-deprecate.rst new file mode 100644 index 0000000000..d3946a5d1c --- /dev/null +++ b/Help/release/dev/AddFileDependencies-deprecate.rst @@ -0,0 +1,5 @@ +AddFileDependencies-deprecate +----------------------------- + +* The :module:`AddFileDependencies` module is deprecated. + Port projects to use :command:`set_property` directly. diff --git a/Modules/AddFileDependencies.cmake b/Modules/AddFileDependencies.cmake index c0388582b9..13b2600f9b 100644 --- a/Modules/AddFileDependencies.cmake +++ b/Modules/AddFileDependencies.cmake @@ -5,13 +5,25 @@ AddFileDependencies ------------------- +.. deprecated:: 3.20 + Add dependencies to a source file. .. code-block:: cmake - add_file_dependencies( ) + add_file_dependencies( ...) Adds the given ```` to the dependencies of file ````. + +Do not use this command in new code. It is just a wrapper around: + +.. code-block:: cmake + + set_property(SOURCE APPEND PROPERTY OBJECT_DEPENDS ...) + +Instead use the :command:`set_property` command to append to the +:prop_sf:`OBJECT_DEPENDS` source file property directly. + #]=======================================================================] function(add_file_dependencies _file)