diff options
| author | Brad King <brad.king@kitware.com> | 2021-02-05 18:14:34 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2021-02-05 21:05:25 (GMT) |
| commit | 5dd356cefcc128c3be8d908a4c89140865467ee2 (patch) | |
| tree | 7c039cdb55ea908fbb806662d1a1668c799fcc12 /Help/command | |
| parent | acb33d0904121f10891cb3aa0622b11d4e527304 (diff) | |
| download | CMake-5dd356cefcc128c3be8d908a4c89140865467ee2.zip CMake-5dd356cefcc128c3be8d908a4c89140865467ee2.tar.gz CMake-5dd356cefcc128c3be8d908a4c89140865467ee2.tar.bz2 | |
Help: Convert some genex names to explicit cross-references
Since commit c2dc7e0f53 (Help: Convert genex documentation to sphinx
domain objects, 2021-01-15) we can use `:genex:` cross-references to
link to named generator expressions. Update some places to do this.
This is meant to demonstrate the capability, not as a comprehensive
sweep.
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/add_custom_command.rst | 4 | ||||
| -rw-r--r-- | Help/command/add_custom_target.rst | 4 | ||||
| -rw-r--r-- | Help/command/target_precompile_headers.rst | 4 |
3 files changed, 6 insertions, 6 deletions
diff --git a/Help/command/add_custom_command.rst b/Help/command/add_custom_command.rst index 9a4efd1..183bb72 100644 --- a/Help/command/add_custom_command.rst +++ b/Help/command/add_custom_command.rst @@ -111,8 +111,8 @@ The options are: Arguments to ``COMMAND`` may use :manual:`generator expressions <cmake-generator-expressions(7)>`. - Use the ``TARGET_FILE`` generator expression to refer to the location of - a target later in the command line (i.e. as a command argument rather + Use the :genex:`TARGET_FILE` generator expression to refer to the location + of a target later in the command line (i.e. as a command argument rather than as the command to execute). Whenever one of the following target based generator expressions are used as diff --git a/Help/command/add_custom_target.rst b/Help/command/add_custom_target.rst index 9c4d60d..22d3f29 100644 --- a/Help/command/add_custom_target.rst +++ b/Help/command/add_custom_target.rst @@ -84,8 +84,8 @@ The options are: Arguments to ``COMMAND`` may use :manual:`generator expressions <cmake-generator-expressions(7)>`. - Use the ``TARGET_FILE`` generator expression to refer to the location of - a target later in the command line (i.e. as a command argument rather + Use the :genex:`TARGET_FILE` generator expression to refer to the location + of a target later in the command line (i.e. as a command argument rather than as the command to execute). Whenever one of the following target based generator expressions are used as diff --git a/Help/command/target_precompile_headers.rst b/Help/command/target_precompile_headers.rst index 7005180..9f7dabb 100644 --- a/Help/command/target_precompile_headers.rst +++ b/Help/command/target_precompile_headers.rst @@ -34,7 +34,7 @@ Repeated calls for the same ``<target>`` will append items in the order called. Projects should generally avoid using ``PUBLIC`` or ``INTERFACE`` for targets that will be :ref:`exported <install(EXPORT)>`, or they should at least use -the ``$<BUILD_INTERFACE:...>`` generator expression to prevent precompile +the :genex:`$<BUILD_INTERFACE:...>` generator expression to prevent precompile headers from appearing in an installed exported target. Consumers of a target should typically be in control of what precompile headers they use, not have precompile headers forced on them by the targets being consumed (since @@ -74,7 +74,7 @@ Arguments to ``target_precompile_headers()`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual for available expressions. -The ``$<COMPILE_LANGUAGE:...>`` generator expression is particularly +The :genex:`$<COMPILE_LANGUAGE:...>` generator expression is particularly useful for specifying a language-specific header to precompile for only one language (e.g. ``CXX`` and not ``C``). In this case, header file names that are not explicitly in double quotes or angle brackets |