r27194 - /trunk/docs/devel/gui_test_checking -- January 15, 2015 - 14:00

Author: bugman
Date: Thu Jan 15 14:00:18 2015
New Revision: 27194

URL: http://svn.gna.org/viewcvs/relax?rev=27194&view=rev
Log:
Created a development document for catching segfaults and other errors in the 
GUI tests.

This is needed as not all wxPython errors can be caught in the Python 
unittest framework.


Added:
    trunk/docs/devel/gui_test_checking

Added: trunk/docs/devel/gui_test_checking
URL: 
http://svn.gna.org/viewcvs/relax/trunk/docs/devel/gui_test_checking?rev=27194&view=auto
==============================================================================
--- trunk/docs/devel/gui_test_checking  (added)
+++ trunk/docs/devel/gui_test_checking  Thu Jan 15 14:00:18 2015
@@ -0,0 +1,7 @@
+Due to the design of wxPython, not all errors can be caught in the GUI tests 
of the test suite.  In addition, segmentation faults due to racing, wxPython 
bugs or other problems can be difficult to pin down.  The following command 
can help with the debugging:
+
+$ rm -f gui_tests.log; for i in {1..10}; do echo Round $i; ./relax 
--gui-tests --time -d >> gui_tests.log 2>&1 || echo -e "\n\nCrash with" $? 
"\n\n\n" >> gui_tests.log; done
+
+This will run the GUI component of the test suite 10 times, to catch 
non-reproducible problems, outputting all results and program faults into the 
'gui_tests.log' file.  To find the problems, run:
+
+$ grep "Error:\|Crash" gui_tests.log