Help: Remove accidental blockquotes around lists
Indenting a list relative to the previous paragraph creates a blockquote. Combined with the natural list indent it results in an overly large left margin.
This commit is contained in:
parent
718043b540
commit
51e4d81f16
@ -141,17 +141,16 @@ The options are:
|
||||
built before any target using this custom command
|
||||
(see policy :policy:`CMP0112`).
|
||||
|
||||
* ``TARGET_FILE``
|
||||
* ``TARGET_LINKER_FILE``
|
||||
* ``TARGET_SONAME_FILE``
|
||||
* ``TARGET_PDB_FILE``
|
||||
* ``TARGET_FILE``
|
||||
* ``TARGET_LINKER_FILE``
|
||||
* ``TARGET_SONAME_FILE``
|
||||
* ``TARGET_PDB_FILE``
|
||||
|
||||
This target-level dependency does NOT add a file-level dependency that would
|
||||
cause the custom command to re-run whenever the executable is recompiled.
|
||||
List target names with the ``DEPENDS`` option to add such file-level
|
||||
dependencies.
|
||||
|
||||
|
||||
``COMMENT``
|
||||
Display the given message before the commands are executed at
|
||||
build time. This will be ignored if ``APPEND`` is given, although a future
|
||||
|
@ -103,10 +103,10 @@ The options are:
|
||||
dependency will be added automatically so that the mentioned target will be
|
||||
built before this custom target (see policy :policy:`CMP0112`).
|
||||
|
||||
* ``TARGET_FILE``
|
||||
* ``TARGET_LINKER_FILE``
|
||||
* ``TARGET_SONAME_FILE``
|
||||
* ``TARGET_PDB_FILE``
|
||||
* ``TARGET_FILE``
|
||||
* ``TARGET_LINKER_FILE``
|
||||
* ``TARGET_SONAME_FILE``
|
||||
* ``TARGET_PDB_FILE``
|
||||
|
||||
The command and arguments are optional and if not specified an empty
|
||||
target will be created.
|
||||
|
@ -122,11 +122,11 @@ constraints):
|
||||
identify a file, a hard link, a symbolic link, or a directory. Two special
|
||||
cases are recognized:
|
||||
|
||||
* The item name consisting of a single dot character ``.`` is a
|
||||
directory name that refers to the current directory.
|
||||
* The item name consisting of a single dot character ``.`` is a
|
||||
directory name that refers to the current directory.
|
||||
|
||||
* The item name consisting of two dot characters ``..`` is a
|
||||
directory name that refers to the parent directory.
|
||||
* The item name consisting of two dot characters ``..`` is a
|
||||
directory name that refers to the parent directory.
|
||||
|
||||
The ``(...)*`` pattern shown above is to indicate that there can be zero
|
||||
or more item names, with multiple items separated by a
|
||||
@ -154,11 +154,11 @@ constraints):
|
||||
|
||||
The following exceptions apply to the above interpretation:
|
||||
|
||||
* If the first character in the ``filename`` is a period, that period is
|
||||
ignored (i.e. a ``filename`` like ``".profile"`` is treated as having
|
||||
no extension).
|
||||
* If the first character in the ``filename`` is a period, that period is
|
||||
ignored (i.e. a ``filename`` like ``".profile"`` is treated as having
|
||||
no extension).
|
||||
|
||||
* If the ``filename`` is either ``.`` or ``..``, it has no extension.
|
||||
* If the ``filename`` is either ``.`` or ``..``, it has no extension.
|
||||
|
||||
The *stem* is the part of the ``filename`` before the extension.
|
||||
|
||||
|
@ -208,18 +208,18 @@ The ``[version]`` argument requests a version with which the package found
|
||||
should be compatible. There are two possible forms in which it may be
|
||||
specified:
|
||||
|
||||
* A single version with the format ``major[.minor[.patch[.tweak]]]``, where
|
||||
each component is a numeric value.
|
||||
* A version range with the format ``versionMin...[<]versionMax`` where
|
||||
``versionMin`` and ``versionMax`` have the same format and constraints
|
||||
on components being integers as the single version. By default, both end
|
||||
points are included. By specifying ``<``, the upper end point will be
|
||||
excluded. Version ranges are only supported with CMake 3.19 or later.
|
||||
Note that it is not possible to extend the compatibility range specified
|
||||
by the package's version file. For example, if the package version file
|
||||
specifies compatibility within a minor version, it is not possible to
|
||||
extend the compatibility to several minor versions by specifying a
|
||||
version range.
|
||||
* A single version with the format ``major[.minor[.patch[.tweak]]]``, where
|
||||
each component is a numeric value.
|
||||
* A version range with the format ``versionMin...[<]versionMax`` where
|
||||
``versionMin`` and ``versionMax`` have the same format and constraints
|
||||
on components being integers as the single version. By default, both end
|
||||
points are included. By specifying ``<``, the upper end point will be
|
||||
excluded. Version ranges are only supported with CMake 3.19 or later.
|
||||
Note that it is not possible to extend the compatibility range specified
|
||||
by the package's version file. For example, if the package version file
|
||||
specifies compatibility within a minor version, it is not possible to
|
||||
extend the compatibility to several minor versions by specifying a
|
||||
version range.
|
||||
|
||||
The ``EXACT`` option requests that the version be matched exactly. This option
|
||||
is incompatible with the specification of a version range.
|
||||
|
@ -45,8 +45,8 @@ be one of the following keywords:
|
||||
``<variable>`` will be empty. Otherwise, ``<variable>`` is a list of 2
|
||||
elements:
|
||||
|
||||
0. Absolute path of the program
|
||||
1. Any command-line arguments present in ``<args>`` as a string
|
||||
0. Absolute path of the program
|
||||
1. Any command-line arguments present in ``<args>`` as a string
|
||||
|
||||
For example:
|
||||
|
||||
|
@ -19,17 +19,17 @@ list.
|
||||
same directory (``CMakeLists.txt``). Visibility can be set in other directory
|
||||
scopes using one or both of the following options:
|
||||
|
||||
``DIRECTORY <dirs>...``
|
||||
The source file properties will be set in each of the ``<dirs>``
|
||||
directories' scopes. CMake must already know about each of these
|
||||
source directories, either by having added them through a call to
|
||||
:command:`add_subdirectory` or it being the top level source directory.
|
||||
Relative paths are treated as relative to the current source directory.
|
||||
``DIRECTORY <dirs>...``
|
||||
The source file properties will be set in each of the ``<dirs>``
|
||||
directories' scopes. CMake must already know about each of these
|
||||
source directories, either by having added them through a call to
|
||||
:command:`add_subdirectory` or it being the top level source directory.
|
||||
Relative paths are treated as relative to the current source directory.
|
||||
|
||||
``TARGET_DIRECTORY <targets>...``
|
||||
The source file properties will be set in each of the directory scopes
|
||||
where any of the specified ``<targets>`` were created (the ``<targets>``
|
||||
must therefore already exist).
|
||||
``TARGET_DIRECTORY <targets>...``
|
||||
The source file properties will be set in each of the directory scopes
|
||||
where any of the specified ``<targets>`` were created (the ``<targets>``
|
||||
must therefore already exist).
|
||||
|
||||
Use :command:`get_source_file_property` to get property values.
|
||||
See also the :command:`set_property(SOURCE)` command.
|
||||
|
@ -25,8 +25,8 @@ or a component GROUP name.
|
||||
Here are some CPack DEB generator wiki resources that are here for historic
|
||||
reasons and are no longer maintained but may still prove useful:
|
||||
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#deb-unix-only
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#deb-unix-only
|
||||
|
||||
List of CPack DEB generator specific variables:
|
||||
|
||||
|
@ -349,12 +349,12 @@ Package
|
||||
|
||||
Archive compression level. The allowable values are:
|
||||
|
||||
* 0 (*No compression*)
|
||||
* 1 (*Fastest compression*)
|
||||
* 3 (*Fast compression*)
|
||||
* 5 (*Normal compression*)
|
||||
* 7 (*Maximum compression*)
|
||||
* 9 (*Ultra compression*)
|
||||
* 0 (*No compression*)
|
||||
* 1 (*Fastest compression*)
|
||||
* 3 (*Fast compression*)
|
||||
* 5 (*Normal compression*)
|
||||
* 7 (*Maximum compression*)
|
||||
* 9 (*Ultra compression*)
|
||||
|
||||
If this variable is not set, QtIFW will use a default compression level,
|
||||
which will typically be 5 (*Normal compression*).
|
||||
|
@ -36,8 +36,8 @@ https://rpm.org/documentation.
|
||||
Here are some CPack RPM generator wiki resources that are here for historic
|
||||
reasons and are no longer maintained but may still prove useful:
|
||||
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#rpm-unix-only
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration
|
||||
- https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#rpm-unix-only
|
||||
|
||||
List of CPack RPM generator specific variables:
|
||||
|
||||
|
@ -8,18 +8,18 @@ Target file component generator expressions do not add target dependencies.
|
||||
The following target-based generator expressions that query for directory or
|
||||
file name components no longer add a dependency on the evaluated target.
|
||||
|
||||
- ``TARGET_FILE_NAME``
|
||||
- ``TARGET_FILE_DIR``
|
||||
- ``TARGET_LINKER_FILE_BASE_NAME``
|
||||
- ``TARGET_LINKER_FILE_NAME``
|
||||
- ``TARGET_LINKER_FILE_DIR``
|
||||
- ``TARGET_SONAME_FILE_NAME``
|
||||
- ``TARGET_SONAME_FILE_DIR``
|
||||
- ``TARGET_PDB_FILE_NAME``
|
||||
- ``TARGET_PDB_FILE_DIR``
|
||||
- ``TARGET_BUNDLE_DIR``
|
||||
- ``TARGET_BUNDLE_DIR_NAME``
|
||||
- ``TARGET_BUNDLE_CONTENT_DIR``
|
||||
- ``TARGET_FILE_NAME``
|
||||
- ``TARGET_FILE_DIR``
|
||||
- ``TARGET_LINKER_FILE_BASE_NAME``
|
||||
- ``TARGET_LINKER_FILE_NAME``
|
||||
- ``TARGET_LINKER_FILE_DIR``
|
||||
- ``TARGET_SONAME_FILE_NAME``
|
||||
- ``TARGET_SONAME_FILE_DIR``
|
||||
- ``TARGET_PDB_FILE_NAME``
|
||||
- ``TARGET_PDB_FILE_DIR``
|
||||
- ``TARGET_BUNDLE_DIR``
|
||||
- ``TARGET_BUNDLE_DIR_NAME``
|
||||
- ``TARGET_BUNDLE_CONTENT_DIR``
|
||||
|
||||
|
||||
In CMake 3.18 and lower a dependency on the evaluated target of the above
|
||||
|
@ -13,26 +13,26 @@ where ``MYVAR`` is the case-sensitive name of an environment variable
|
||||
to be modified. Entries are considered in the order specified in the
|
||||
property's value. The ``OP`` may be one of:
|
||||
|
||||
- ``reset``: Reset to the unmodified value, ignoring all modifications to
|
||||
``MYVAR`` prior to this entry. Note that this will reset the variable to
|
||||
the value set by :prop_test:`ENVIRONMENT`, if it was set, and otherwise
|
||||
to its state from the rest of the CTest execution.
|
||||
- ``set``: Replaces the current value of ``MYVAR`` with ``VALUE``.
|
||||
- ``unset``: Unsets the current value of ``MYVAR``.
|
||||
- ``string_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR``.
|
||||
- ``string_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR``.
|
||||
- ``path_list_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using the host platform's path list separator (``;`` on Windows
|
||||
and ``:`` elsewhere).
|
||||
- ``path_list_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using the host platform's path list separator (``;`` on Windows
|
||||
and ``:`` elsewhere).
|
||||
- ``cmake_list_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using ``;`` as the separator.
|
||||
- ``cmake_list_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using ``;`` as the separator.
|
||||
- ``reset``: Reset to the unmodified value, ignoring all modifications to
|
||||
``MYVAR`` prior to this entry. Note that this will reset the variable to
|
||||
the value set by :prop_test:`ENVIRONMENT`, if it was set, and otherwise
|
||||
to its state from the rest of the CTest execution.
|
||||
- ``set``: Replaces the current value of ``MYVAR`` with ``VALUE``.
|
||||
- ``unset``: Unsets the current value of ``MYVAR``.
|
||||
- ``string_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR``.
|
||||
- ``string_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR``.
|
||||
- ``path_list_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using the host platform's path list separator (``;`` on Windows
|
||||
and ``:`` elsewhere).
|
||||
- ``path_list_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using the host platform's path list separator (``;`` on Windows
|
||||
and ``:`` elsewhere).
|
||||
- ``cmake_list_append``: Appends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using ``;`` as the separator.
|
||||
- ``cmake_list_prepend``: Prepends singular ``VALUE`` to the current value of
|
||||
``MYVAR`` using ``;`` as the separator.
|
||||
|
||||
Unrecognized ``OP`` values will result in the test failing before it is
|
||||
executed. This is so that future operations may be added without changing
|
||||
|
@ -236,28 +236,28 @@ Modules
|
||||
their library names rather than header names. The old variables are provided
|
||||
for compatibility:
|
||||
|
||||
- ``X11_Xxf86misc_INCLUDE_PATH`` instead of ``X11_xf86misc_INCLUDE_PATH``
|
||||
- ``X11_Xxf86misc_LIB`` instead of ``X11_xf86misc_LIB``
|
||||
- ``X11_Xxf86misc_FOUND`` instead of ``X11_xf86misc_FOUND``
|
||||
- ``X11_Xxf86vm_INCLUDE_PATH`` instead of ``X11_xf86vmode_INCLUDE_PATH``
|
||||
- ``X11_Xxf86vm_LIB`` instead of ``X11_xf86vmode_LIB``
|
||||
- ``X11_Xxf86vm_FOUND`` instead of ``X11_xf86vmode_FOUND``
|
||||
- ``X11_xkbfile_INCLUDE_PATH`` instead of ``X11_Xkbfile_INCLUDE_PATH``
|
||||
- ``X11_xkbfile_LIB`` instead of ``X11_Xkbfile_LIB``
|
||||
- ``X11_xkbfile_FOUND`` instead of ``X11_Xkbfile_FOUND``
|
||||
- ``X11_Xtst_INCLUDE_PATH`` instead of ``X11_XTest_INCLUDE_PATH``
|
||||
- ``X11_Xtst_LIB`` instead of ``X11_XTest_LIB``
|
||||
- ``X11_Xtst_FOUND`` instead of ``X11_XTest_FOUND``
|
||||
- ``X11_Xss_INCLUDE_PATH`` instead of ``X11_Xscreensaver_INCLUDE_PATH``
|
||||
- ``X11_Xss_LIB`` instead of ``X11_Xscreensaver_LIB``
|
||||
- ``X11_Xss_FOUND`` instead of ``X11_Xscreensaver_FOUND``
|
||||
- ``X11_Xxf86misc_INCLUDE_PATH`` instead of ``X11_xf86misc_INCLUDE_PATH``
|
||||
- ``X11_Xxf86misc_LIB`` instead of ``X11_xf86misc_LIB``
|
||||
- ``X11_Xxf86misc_FOUND`` instead of ``X11_xf86misc_FOUND``
|
||||
- ``X11_Xxf86vm_INCLUDE_PATH`` instead of ``X11_xf86vmode_INCLUDE_PATH``
|
||||
- ``X11_Xxf86vm_LIB`` instead of ``X11_xf86vmode_LIB``
|
||||
- ``X11_Xxf86vm_FOUND`` instead of ``X11_xf86vmode_FOUND``
|
||||
- ``X11_xkbfile_INCLUDE_PATH`` instead of ``X11_Xkbfile_INCLUDE_PATH``
|
||||
- ``X11_xkbfile_LIB`` instead of ``X11_Xkbfile_LIB``
|
||||
- ``X11_xkbfile_FOUND`` instead of ``X11_Xkbfile_FOUND``
|
||||
- ``X11_Xtst_INCLUDE_PATH`` instead of ``X11_XTest_INCLUDE_PATH``
|
||||
- ``X11_Xtst_LIB`` instead of ``X11_XTest_LIB``
|
||||
- ``X11_Xtst_FOUND`` instead of ``X11_XTest_FOUND``
|
||||
- ``X11_Xss_INCLUDE_PATH`` instead of ``X11_Xscreensaver_INCLUDE_PATH``
|
||||
- ``X11_Xss_LIB`` instead of ``X11_Xscreensaver_LIB``
|
||||
- ``X11_Xss_FOUND`` instead of ``X11_Xscreensaver_FOUND``
|
||||
|
||||
The following variables are deprecated completely since they were
|
||||
essentially duplicates:
|
||||
|
||||
- ``X11_Xinput_INCLUDE_PATH`` (use ``X11_Xi_INCLUDE_PATH``)
|
||||
- ``X11_Xinput_LIB`` (use ``X11_Xi_LIB``)
|
||||
- ``X11_Xinput_FOUND`` (use ``X11_Xi_FOUND``)
|
||||
- ``X11_Xinput_INCLUDE_PATH`` (use ``X11_Xi_INCLUDE_PATH``)
|
||||
- ``X11_Xinput_LIB`` (use ``X11_Xi_LIB``)
|
||||
- ``X11_Xinput_FOUND`` (use ``X11_Xi_FOUND``)
|
||||
|
||||
* The :module:`FindX11` now provides ``X11_Xext_INCLUDE_PATH``.
|
||||
|
||||
|
@ -54,9 +54,9 @@
|
||||
File paths must conform to one of the following patterns (``*`` is a
|
||||
wildcard, and optional parts are shown as ``[...]``):
|
||||
|
||||
* ``[/path/to/]FwName[.framework]``
|
||||
* ``[/path/to/]FwName.framework/FwName[suffix]``
|
||||
* ``[/path/to/]FwName.framework/Versions/*/FwName[suffix]``
|
||||
* ``[/path/to/]FwName[.framework]``
|
||||
* ``[/path/to/]FwName.framework/FwName[suffix]``
|
||||
* ``[/path/to/]FwName.framework/Versions/*/FwName[suffix]``
|
||||
|
||||
Note that CMake recognizes and automatically handles framework targets,
|
||||
even without using the :genex:`$<LINK_LIBRARY:FRAMEWORK,...>` expression.
|
||||
|
@ -84,17 +84,20 @@ Main functions provided by the module
|
||||
are set depending on the extension of the matched file:
|
||||
|
||||
if match is **.resx** file:
|
||||
- VS_CSHARP_AutoGen "True"
|
||||
- VS_CSHARP_DesignTime "True"
|
||||
- VS_CSHARP_DependentUpon <resx-filename>
|
||||
|
||||
- VS_CSHARP_AutoGen "True"
|
||||
- VS_CSHARP_DesignTime "True"
|
||||
- VS_CSHARP_DependentUpon <resx-filename>
|
||||
|
||||
if match is **.cs** file:
|
||||
- VS_CSHARP_DependentUpon <cs-filename>
|
||||
|
||||
- VS_CSHARP_DependentUpon <cs-filename>
|
||||
|
||||
if match is **.settings** file:
|
||||
- VS_CSHARP_AutoGen "True"
|
||||
- VS_CSHARP_DesignTimeSharedInput "True"
|
||||
- VS_CSHARP_DependentUpon <settings-filename>
|
||||
|
||||
- VS_CSHARP_AutoGen "True"
|
||||
- VS_CSHARP_DesignTimeSharedInput "True"
|
||||
- VS_CSHARP_DependentUpon <settings-filename>
|
||||
|
||||
.. note::
|
||||
|
||||
@ -122,7 +125,7 @@ Main functions provided by the module
|
||||
If a match is found, the source file properties of the ``.xaml.cs``
|
||||
file are set:
|
||||
|
||||
- VS_CSHARP_DependentUpon <xaml-filename>
|
||||
- VS_CSHARP_DependentUpon <xaml-filename>
|
||||
|
||||
Helper functions which are used by the above ones
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
Loading…
Reference in New Issue
Block a user