]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/tech/tn0017.txt
Updated build files.
[wxWidgets.git] / docs / tech / tn0017.txt
index f4a0606c3748f2d8d7adf3734ddf6490964cc245..b9ae2b7cfd28a316b1962fb67c378bebe7771606 100644 (file)
@@ -1,7 +1,7 @@
-                    How to write unit tests for wxWindows
+                    How to write unit tests for wxWidgets
                     =====================================
 
- Unit tests for wxWindows are written using small cppunit framework. To compile
+ Unit tests for wxWidgets are written using small cppunit framework. To compile
 (but not to run) them you need to have it installed. Hence the first part of
 this note explains how to do it while the second one explains how to write the
 test.
@@ -69,6 +69,25 @@ III. Running the tests
    or to list the tests:
       test -L MBConvTestCase
 
+5. Fault navigation.
+   VC++ users can run the programs as a post build step (Projects/Settings/
+   Post-build step) to see the test results in an IDE window. This allows
+   errors to be jumped to in the same way as for compiler errors, for
+   example by pressing F4 or highlighting the error and pressing return.
+   
+   Similarly for makefile users: makefiles can be modified to execute the
+   test programs as a final step. Then you can navigate to any errors in the
+   same way as for compiler errors, if your editor supports that.
+
+   Another alternative is to run the tests manually, redirecting the output
+   to a file. Then use your editor to jump to any failures. Using Vim, for
+   example, ':cf test.log' would take you to the first error in test.log, and
+   ':cn' to the next.
+
+   If you would like to set a breakpoint on a failing test using a debugger,
+   put the breakpoint on the function 'CppUnit::Asserter::fail()'. This will
+   stop on each failing test.
+
 
 IV. Notes
 ---------
@@ -100,5 +119,5 @@ IV. Notes
 
 === EOF ===
 
-Author:  VZ
+Author:  VZ & MW
 Version: $Id$