diff options
Diffstat (limited to 'share/cmake-3.17/Help/command/source_group.rst')
-rw-r--r-- | share/cmake-3.17/Help/command/source_group.rst | 58 |
1 files changed, 0 insertions, 58 deletions
diff --git a/share/cmake-3.17/Help/command/source_group.rst b/share/cmake-3.17/Help/command/source_group.rst deleted file mode 100644 index 6623c98..0000000 --- a/share/cmake-3.17/Help/command/source_group.rst +++ /dev/null @@ -1,58 +0,0 @@ -source_group ------------- - -Define a grouping for source files in IDE project generation. -There are two different signatures to create source groups. - -.. code-block:: cmake - - source_group(<name> [FILES <src>...] [REGULAR_EXPRESSION <regex>]) - source_group(TREE <root> [PREFIX <prefix>] [FILES <src>...]) - -Defines a group into which sources will be placed in project files. -This is intended to set up file tabs in Visual Studio. -The options are: - -``TREE`` - CMake will automatically detect, from ``<src>`` files paths, source groups - it needs to create, to keep structure of source groups analogically to the - actual files and directories structure in the project. Paths of ``<src>`` - files will be cut to be relative to ``<root>``. - -``PREFIX`` - Source group and files located directly in ``<root>`` path, will be placed - in ``<prefix>`` source groups. - -``FILES`` - Any source file specified explicitly will be placed in group - ``<name>``. Relative paths are interpreted with respect to the - current source directory. - -``REGULAR_EXPRESSION`` - Any source file whose name matches the regular expression will - be placed in group ``<name>``. - -If a source file matches multiple groups, the *last* group that -explicitly lists the file with ``FILES`` will be favored, if any. -If no group explicitly lists the file, the *last* group whose -regular expression matches the file will be favored. - -The ``<name>`` of the group and ``<prefix>`` argument may contain backslashes -to specify subgroups: - -.. code-block:: cmake - - source_group(outer\\inner ...) - source_group(TREE <root> PREFIX sources\\inc ...) - -For backwards compatibility, the short-hand signature - -.. code-block:: cmake - - source_group(<name> <regex>) - -is equivalent to - -.. code-block:: cmake - - source_group(<name> REGULAR_EXPRESSION <regex>) |