Adding documentation for CXXTEST_RUNNING

doc/examples/MyTestSuite12.h

@@ -0,0 +1,24 @@
+// MyTestSuite12.h
+#include <cxxtest/TestSuite.h>
+
+class MyTestSuite1 : public CxxTest::TestSuite
+{
+public:
+    void testAddition(void)
+    {
+        TS_ASSERT(1 + 1 > 1);
+        TS_ASSERT_EQUALS(1 + 1, 2);
+    }
+};
+
+
+#ifndef CXXTEST_RUNNING
+#include <iostream>
+
+int main(int argc, char *argv[])
+{
+
+    std::cout << "Non-CxxTest stuff is happening now." << std::endl;
+
+}
+#endif

doc/examples/buildRunner25.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+. GetGlobals.sh
+export PATH=$CXXTEST/bin:$PATH
+
+# @main:
+cxxtestgen --error-printer -o runner.cpp MyTestSuite12.h
+# @:main
+
+# @compile:
+g++ -o runner -I$CXXTEST runner.cpp
+# @:compile
+
+./runner > buildRunner.log
+# @run:
+./runner
+# @:run
+\rm -f runner runner.cpp
+
+
+cp MyTestSuite12.h runner2.cpp
+g++ -o runner2 -I$CXXTEST runner2.cpp
+./runner2
+\rm -f runner2 runner2.cpp

doc/examples/buildRunner25.txt

@@ -0,0 +1,2 @@
+Running cxxtest tests (1 test).OK!
+Non-CxxTest stuff is happening now.

doc/guide.txt

@@ -703,6 +703,16 @@ supports this with the +CXXTEST_STD()+ macro.  For example,
 handles the mapping of this to +cout+ or +std::cout+ depending on
 options provided to +cxxtestgen+.
 
+Finally, CxxTest defines the +CXXTEST_RUNNING+ preprocessor macro.
+This can be used in a test header file to define code that is
+executed when the header is not used in a test runner.  For example:
+[source,{cpp}]
+-----
+include::examples/MyTestSuite12.h[]
+----
+Note that test suites derived from +CxxTest::TestSuite+ class cannot
+easily be built outside of the test runner.
+
 
 
 Customizing Test Fixtures