[Cmake-commits] CMake branch, next, updated. v2.8.7-2691-gf6b791b

Rolf Eike Beer eike at sf-mail.de
Fri Feb 17 15:02:25 EST 2012


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  f6b791bedefedf3fefb86bb7f893749a88715d5f (commit)
       via  378f2291593c5b1d7d9fcd03029b931ce674a3d2 (commit)
      from  7c29e989f39c726546c45c8645d93736f7906b6d (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=f6b791bedefedf3fefb86bb7f893749a88715d5f
commit f6b791bedefedf3fefb86bb7f893749a88715d5f
Merge: 7c29e98 378f229
Author:     Rolf Eike Beer <eike at sf-mail.de>
AuthorDate: Fri Feb 17 15:02:22 2012 -0500
Commit:     CMake Topic Stage <kwrobot at kitware.com>
CommitDate: Fri Feb 17 15:02:22 2012 -0500

    Merge topic 'document-test-layout' into next
    
    378f229 Tests: document where to put tests


http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=378f2291593c5b1d7d9fcd03029b931ce674a3d2
commit 378f2291593c5b1d7d9fcd03029b931ce674a3d2
Author:     Rolf Eike Beer <eike at sf-mail.de>
AuthorDate: Fri Feb 17 21:02:08 2012 +0100
Commit:     Rolf Eike Beer <eike at sf-mail.de>
CommitDate: Fri Feb 17 21:02:08 2012 +0100

    Tests: document where to put tests

diff --git a/Tests/README b/Tests/README
new file mode 100644
index 0000000..9b0f5c1
--- /dev/null
+++ b/Tests/README
@@ -0,0 +1,34 @@
+If you think about adding a new testcase then here is a small checklist you
+can run through to find a proper place for it. Go through the list from the
+beginning and stop once you find something that matches your tests needs,
+i.e. if you will test a module and only need the configure mode use the
+instructions from section 2, not 3.
+
+1. Your testcase can run in CMake script mode, i.e. "cmake -P something"
+
+Put your test in Tests/CMakeTests/ directory as a .cmake.in file. It will be
+put into the test binary directory by configure_file(... @ONLY) and run from
+there. Use the AddCMakeTest() macro in Tests/CMakeTests/CMakeLists.txt to add
+your test to the test runs.
+
+2. Your test needs CMake to run in configure mode, but will not build anything
+
+This includes tests that will build something using try_compile() and friends,
+but nothing that expects add_executable(), add_library(), or add_test() to run.
+
+If this matches your test you should put it into the Tests/CMakeOnly/ directory.
+Create a subdirectory named like your test and write the CMakeLists.txt you
+need into that subdirectory. Use the add_CMakeOnly_test() macro from
+Tests/CMakeOnly/CMakeLists.txt to add your test to the test runs.
+
+3. If you are testing something from the Modules directory
+
+Put your test in the Tests/Modules/ directory. Create a subdirectory there
+named after your test. Use the ADD_TEST_MACRO macro from Tests/CMakeLists.txt
+to add your test to the test run. If you have put your stuff in
+Tests/Modules/Foo then you call it using ADD_TEST_MACRO(Module.Foo Foo).
+
+4. You are doing other stuff.
+
+Find a good place ;) In doubt mail to cmake-developers at cmake.org and ask for
+advise.

-----------------------------------------------------------------------

Summary of changes:
 Tests/README |   34 ++++++++++++++++++++++++++++++++++
 1 files changed, 34 insertions(+), 0 deletions(-)
 create mode 100644 Tests/README


hooks/post-receive
-- 
CMake


More information about the Cmake-commits mailing list