diff options
author | Brad King <brad.king@kitware.com> | 2024-10-25 13:53:57 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2024-10-25 14:23:37 (GMT) |
commit | 39fd396421d7b5012e8fb567710ea1c99d67eeab (patch) | |
tree | 3d27db3bd64ef5ee191c388db27b1b3f5f307ed0 /Help/prop_tgt/EXPORT_NO_SYSTEM.rst | |
parent | ebd038613ebe3722afe78a1cd33c8de7d77075df (diff) | |
download | CMake-39fd396421d7b5012e8fb567710ea1c99d67eeab.zip CMake-39fd396421d7b5012e8fb567710ea1c99d67eeab.tar.gz CMake-39fd396421d7b5012e8fb567710ea1c99d67eeab.tar.bz2 |
LINK_LIBRARIES_STRATEGY: Rename strategies to clarify expectations
Since commit 7abd3137b7 (Linking: Optionally reorder direct dependencies
from LINK_LIBRARIES, 2024-09-19, v3.31.0-rc1~53^2) the strategy name
`PRESERVE_ORDER` has led users to expect that it strictly preserves
order. While the part of the link line generation logic controlled by
`LINK_LIBRARIES_STRATEGY` does preserve order, it is not the last step.
Toolchain-specific de-duplication can cause the order to change on the
actual link line generated in the build system.
Rename the strategies:
* `PRESERVE_ORDER` => `REORDER_MINIMALLY`
* `REORDER` => `REORDER_FREELY`
The new names make it clear that reordering is always possible, just to
varying degrees. Update the `LINK_LIBRARIES_STRATEGY` documentation to
clarify that the strategies do not directly control the final link line.
Fixes: #26400
Issue: #26271
Diffstat (limited to 'Help/prop_tgt/EXPORT_NO_SYSTEM.rst')
0 files changed, 0 insertions, 0 deletions