diff options
| author | Brad King <brad.king@kitware.com> | 2023-05-19 12:50:37 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2023-05-19 12:50:44 (GMT) |
| commit | 779f704c25186651f188e166c40e1e0b8d5d9f20 (patch) | |
| tree | 326a8ff65fef7209a68d86760ea7fa51c5558a65 /Help | |
| parent | f1438379c2c919671d64c60f657b78962a1eedc9 (diff) | |
| parent | 949dcdb3bcc8f3c1084dc933240dbe3546941dad (diff) | |
| download | CMake-779f704c25186651f188e166c40e1e0b8d5d9f20.zip CMake-779f704c25186651f188e166c40e1e0b8d5d9f20.tar.gz CMake-779f704c25186651f188e166c40e1e0b8d5d9f20.tar.bz2 | |
Merge topic 'doc-PRE_BUILD'
949dcdb3bc Help: Clarify PRE_BUILD option for add_custom_command()
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !8494
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/command/add_custom_command.rst | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/Help/command/add_custom_command.rst b/Help/command/add_custom_command.rst index 1ccd434..7b3aa1a 100644 --- a/Help/command/add_custom_command.rst +++ b/Help/command/add_custom_command.rst @@ -489,9 +489,12 @@ When the command will happen is determined by which of the following is specified: ``PRE_BUILD`` - On :ref:`Visual Studio Generators`, run before any other rules are - executed within the target. - On other generators, run just before ``PRE_LINK`` commands. + This option has unique behavior for the :ref:`Visual Studio Generators`. + When using one of the Visual Studio generators, the command will run before + any other rules are executed within the target. With all other generators, + this option behaves the same as ``PRE_LINK`` instead. Because of this, + it is recommended to avoid using ``PRE_BUILD`` except when it is known that + a Visual Studio generator is being used. ``PRE_LINK`` Run after sources have been compiled but before linking the binary or running the librarian or archiver tool of a static library. |