summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-08-16 14:43:10 (GMT)
committerKitware Robot <kwrobot@kitware.com>2017-08-16 14:43:17 (GMT)
commit1e77d0dbef67f835d4a736df21069a8d6b43f5b9 (patch)
treeb852b1945cd5af2aae7bb352012db43e116f6bc4 /Help
parent131af5d591ac45a6ab49ccb760dd08e15ef36d81 (diff)
parent6c5e03d6d4f974781e71e51116e4ac5d982c7d79 (diff)
downloadCMake-1e77d0dbef67f835d4a736df21069a8d6b43f5b9.zip
CMake-1e77d0dbef67f835d4a736df21069a8d6b43f5b9.tar.gz
CMake-1e77d0dbef67f835d4a736df21069a8d6b43f5b9.tar.bz2
Merge topic 'autogen-autouic-lookup'
6c5e03d6 Merge branch 'backport-autogen-autouic-lookup' into autogen-autouic-lookup fb5db079 Autogen: Extend AUTOUIC search paths test d8a99dd2 Autogen: Update AUTOUIC documentation for search paths 02e6c548 Autogen: Restore AUTOUIC lookup paths from 3.8.2 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1140
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-qt.7.rst21
1 files changed, 15 insertions, 6 deletions
diff --git a/Help/manual/cmake-qt.7.rst b/Help/manual/cmake-qt.7.rst
index b3b09d1..e345cd2 100644
--- a/Help/manual/cmake-qt.7.rst
+++ b/Help/manual/cmake-qt.7.rst
@@ -70,7 +70,8 @@ be included by the user in the C++ implementation file with a preprocessor
Included ``moc_*.cpp`` and ``*.moc`` files will be generated in the
``<AUTOGEN_BUILD_DIR>/include`` directory which is
automatically added to the target's :prop_tgt:`INCLUDE_DIRECTORIES`.
-(This differs from CMake 3.7 and below; see their documentation for details.)
+
+* This differs from CMake 3.7 and below; see their documentation for details.
* For multi configuration generators, the include directory is
``<AUTOGEN_BUILD_DIR>/include_<CONFIG>``.
@@ -110,15 +111,23 @@ inspects the C++ files in the target to determine if they require ``uic`` to
be run, and to create rules to execute ``uic`` at the appropriate time.
If a preprocessor ``#include`` directive is found which matches
-``ui_<basename>.h``, and a ``<basename>.ui`` file exists, then ``uic`` will
-be executed to generate the appropriate file. The ``<basename>.ui`` file is
-searched for first in the vicinity of including file and afterwards in the
-optional :prop_tgt:`AUTOUIC_SEARCH_PATHS` of the target.
+``<path>ui_<basename>.h``, and a ``<basename>.ui`` file exists,
+then ``uic`` will be executed to generate the appropriate file.
+The ``<basename>.ui`` file is searched for in the following places
+
+1. ``<source_dir>/<basename>.ui``
+2. ``<source_dir>/<path><basename>.ui``
+3. ``<AUTOUIC_SEARCH_PATHS>/<basename>.ui``
+4. ``<AUTOUIC_SEARCH_PATHS>/<path><basename>.ui``
+
+where ``<source_dir>`` is the directory of the C++ file and
+:prop_tgt:`AUTOUIC_SEARCH_PATHS` is a list of additional search paths.
The generated generated ``ui_*.h`` files are placed in the
``<AUTOGEN_BUILD_DIR>/include`` directory which is
automatically added to the target's :prop_tgt:`INCLUDE_DIRECTORIES`.
-(This differs from CMake 3.7 and below; see their documentation for details.)
+
+* This differs from CMake 3.7 and below; see their documentation for details.
* For multi configuration generators, the include directory is
``<AUTOGEN_BUILD_DIR>/include_<CONFIG>``.