This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "CMake".
The branch, next has been updated
via 5c87f57191ec5d137e9d51df10c0a2f8d85f1249 (commit)
via 0060e955db6d200613db46937211cc971fd252bb (commit)
from 1b41b61cff7210c569b904c8db8bdba73a3b35b7 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=5c87f57191ec5d137e9d51df10c0a2f8d85f1249
commit 5c87f57191ec5d137e9d51df10c0a2f8d85f1249
Merge: 1b41b61 0060e95
Author: Brad King <brad.k...@kitware.com>
AuthorDate: Thu Dec 5 13:25:10 2013 -0500
Commit: CMake Topic Stage <kwro...@kitware.com>
CommitDate: Thu Dec 5 13:25:10 2013 -0500
Merge topic 'doc-source_group-FILES' into next
0060e95 Help: Format and clarify source_group() documentation (#14631)
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=0060e955db6d200613db46937211cc971fd252bb
commit 0060e955db6d200613db46937211cc971fd252bb
Author: Brad King <brad.k...@kitware.com>
AuthorDate: Thu Dec 5 13:22:57 2013 -0500
Commit: Brad King <brad.k...@kitware.com>
CommitDate: Thu Dec 5 13:22:57 2013 -0500
Help: Format and clarify source_group() documentation (#14631)
Refine the .rst formatting. Document the FILES option explicitly
and specify how it treats relative paths.
diff --git a/Help/command/source_group.rst b/Help/command/source_group.rst
index 77bb9ad..6e3829c 100644
--- a/Help/command/source_group.rst
+++ b/Help/command/source_group.rst
@@ -1,28 +1,44 @@
source_group
------------
-Define a grouping for sources in the makefile.
+Define a grouping for source files in IDE project generation.
-::
+.. code-block:: cmake
- source_group(name [REGULAR_EXPRESSION regex] [FILES src1 src2 ...])
+ source_group(<name> [FILES <src>...] [REGULAR_EXPRESSION <regex>])
Defines a group into which sources will be placed in project files.
-This is mainly used to setup file tabs in Visual Studio. Any file
-whose name is listed or matches the regular expression will be placed
-in this group. If a file matches multiple groups, the LAST group that
-explicitly lists the file will be favored, if any. If no group
-explicitly lists the file, the LAST group whose regular expression
-matches the file will be favored.
+This is intended to set up file tabs in Visual Studio.
+The options are:
-The name of the group may contain backslashes to specify subgroups:
+``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 may contain backslashes to specify subgroups:
+
+.. code-block:: cmake
source_group(outer\\inner ...)
-For backwards compatibility, this command also supports the format:
+For backwards compatibility, the short-hand signature
+
+.. code-block:: cmake
+
+ source_group(<name> <regex>)
+
+is equivalent to
-::
+.. code-block:: cmake
- source_group(name regex)
+ source_group(<name> REGULAR_EXPRESSION <regex>)
-----------------------------------------------------------------------
Summary of changes:
Help/command/source_group.rst | 44 +++++++++++++++++++++++++++-------------
1 files changed, 30 insertions(+), 14 deletions(-)
hooks/post-receive
--
CMake
_______________________________________________
Cmake-commits mailing list
Cmake-commits@cmake.org
http://public.kitware.com/cgi-bin/mailman/listinfo/cmake-commits
