summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/AUTOMOC_PATH_PREFIX.rst
Commit message (Collapse)AuthorAgeFilesLines
* Help: remove links from pages to themselvesBen Boeckel2022-11-181-2/+2
| | | | | At least the top-reference links. Internal `:ref:` usages have been left intact.
* Merge topic 'automoc-path-prefix-off'Brad King2020-08-111-3/+2
|\ | | | | | | | | | | | | | | | | | | 5b5be34811 Help: Add 3.18.2 release note about AUTOMOC_PATH_PREFIX default change db659e18bc Merge branch 'backport-3.17-automoc-path-prefix-off' e503fbe38a Merge branch 'backport-3.16-automoc-path-prefix-off' 4c33b305a0 Autogen: Turn off moc path prefix generation by default Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5105
| * Merge branch 'backport-3.16-automoc-path-prefix-off'Brad King2020-08-101-3/+2
| |\
| | * Autogen: Turn off moc path prefix generation by defaultJoerg Bornemann2020-08-101-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Change the default value of `CMAKE_AUTOMOC_PATH_PREFIX` to `OFF` to restore compatibility with behavior of CMake 3.15 and below. C++ source files that are generated by Qt's meta object compiler (moc) include the header file that was passed as input argument to moc. This is usually a path relative to the source directory, for example #include "../../source/dir/myobject.h" That is problematic for reproducible builds as described in #18815. To cope with that, the target property AUTOMOC_PATH_PREFIX was introduced in CMake 3.16 by commit d018d27c10 (Autogen: Add moc path prefix generation (AUTOMOC_PATH_PREFIX), 2019-09-13, v3.16.0-rc1~94^2~4). The property is default-initialized from the variable `CMAKE_AUTOMOC_PATH_PREFIX`, which defaults to `ON`. If this property is ON, and myobject.h is located in an include directory of the target, moc-generated C++ files include the file without the "path prefix": #include "myobject.h" This behavior, however, can break projects that have equally named header files in different include directories. As "not breaking existing projects" trumps "have reproducible builds by default" we change the default of `CMAKE_AUTOMOC_PATH_PREFIX` to `OFF`. Also, it is now possible to pass `-DCMAKE_AUTOMOC_PATH_PREFIX=ON` on the CMake command line. Before, it was overridden in `CMakeGenericSystem`. Fixes: #20598 Issue: #18815
* | | Help: Add Sphinx 'versionadded' directives to each top-level documentKitware Robot2020-07-061-0/+2
|/ / | | | | | | | | | | | | Run the `Utilities/Sphinx/update_versions.py` script to add initial markup to every top-level document and find module. Issue: #19715
* | Help: Clean up formatting and typos in autogen docsCraig Scott2020-01-091-2/+2
|/
* Help: Add documentation for AUTOMOC_PATH_PREFIXSebastian Holtermann2019-09-181-0/+32