[Cmake-commits] CMake branch, next, updated. v2.8.4-1324-gf32e4ff
Brad King
brad.king at kitware.com
Fri Apr 1 13:49:12 EDT 2011
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 f32e4ff62d614c1609247453902427b4dc292c09 (commit)
via ede46d9d91485c224d4b2ca36c8c864263923eec (commit)
from ba026f8e6c14b57dcecddc2108cfa5762e82f1d8 (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=f32e4ff62d614c1609247453902427b4dc292c09
commit f32e4ff62d614c1609247453902427b4dc292c09
Merge: ba026f8 ede46d9
Author: Brad King <brad.king at kitware.com>
AuthorDate: Fri Apr 1 13:49:02 2011 -0400
Commit: CMake Topic Stage <kwrobot at kitware.com>
CommitDate: Fri Apr 1 13:49:02 2011 -0400
Merge topic 'module-readme' into next
ede46d9 Modules: Add comment and copyright notice validation to readme.txt
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=ede46d9d91485c224d4b2ca36c8c864263923eec
commit ede46d9d91485c224d4b2ca36c8c864263923eec
Author: Brad King <brad.king at kitware.com>
AuthorDate: Fri Apr 1 13:46:36 2011 -0400
Commit: Brad King <brad.king at kitware.com>
CommitDate: Fri Apr 1 13:46:36 2011 -0400
Modules: Add comment and copyright notice validation to readme.txt
Document for module authors how to format the copyright notice and
test it. Also provide a hint for previewing the module documentation
formatting.
diff --git a/Modules/readme.txt b/Modules/readme.txt
index dd52000..e2d7f06 100644
--- a/Modules/readme.txt
+++ b/Modules/readme.txt
@@ -64,10 +64,32 @@ For example:
# VAR_REALLY_COOL - cool right?
#
+Test the documentation formatting by running "cmake --help-module FindXXX".
+Edit the comments until the output of this command looks satisfactory.
+
To have a .cmake file in this directory NOT show up in the
modules documentation, you should start the file with a blank
line.
+After the documentation, leave a *BLANK* line, and then add a
+copyright and licence notice block like this one:
+
+#=============================================================================
+# Copyright 2009-2011 Your Name
+#
+# Distributed under the OSI-approved BSD License (the "License");
+# see accompanying file Copyright.txt for details.
+#
+# This software is distributed WITHOUT ANY WARRANTY; without even the
+# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the License for more information.
+#=============================================================================
+# (To distribute this file outside of CMake, substitute the full
+# License text for the above reference.)
+
+The layout of the notice block is strictly enforced by the ModuleNotices test.
+Only the year range and name may be changed freely.
+
A FindXXX.cmake module will typically be loaded by the command
FIND_PACKAGE(XXX [major[.minor[.patch[.tweak]]]] [EXACT]
-----------------------------------------------------------------------
Summary of changes:
Modules/readme.txt | 22 ++++++++++++++++++++++
1 files changed, 22 insertions(+), 0 deletions(-)
hooks/post-receive
--
CMake
More information about the Cmake-commits
mailing list