Index: docs/manual/bisecting.png
==================================================================
--- docs/manual/bisecting.png
+++ docs/manual/bisecting.png
cannot compute difference between binary files
Index: docs/manual/debugging.txt
==================================================================
--- docs/manual/debugging.txt
+++ docs/manual/debugging.txt
@@ -15,10 +15,28 @@
// You should have received a copy of the GNU General Public License
// along with Megatest. If not, see .
Debugging
---------
+
+Well Written Tests
+~~~~~~~~~~~~~~~~~~
+
+Test Design and Surfacing
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Design your tests to surface errors. Ensure that all logs are processed by logpro and can be reached by a mouse click or two from the test control panel.
+
+
+
+using the tool to make life easier
+
+layers - less is often more
+
+
+Clicks-to-error
+
A word on Bisecting
~~~~~~~~~~~~~~~~~~~
Bisecting is a debug strategy intended to speed up finding the root
@@ -77,10 +95,26 @@
NOTE 1: visual feedback can take some time, give it a few seconds and
you will see the step change color to blue as it starts running.
NOTE 2: steping through only works if you are using ezsteps.
+
+Bisecting megatest.csh/sh
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Sometimes finding the environment variable that is causing the problem can be very difficult. Bisection can be applied.
+
+Edit the megatest.csh or megatest.sh file and comment out 50% per round, source in fresh xterm and run the test.
+
+This idea can also be applied to your .cshrc, .bashrc, .aliases and other similar files.
+
+csh and -f
+^^^^^^^^^^
+
+A common issue when tcsh or csh shells are used for scripting is to forget or choose to not use -f in your #! line
+
+.
Config File Processing
^^^^^^^^^^^^^^^^^^^^^^
As described above it is often helpful to know the content of
Index: docs/manual/megatest-test-stages.png
==================================================================
--- docs/manual/megatest-test-stages.png
+++ docs/manual/megatest-test-stages.png
cannot compute difference between binary files
Index: docs/manual/megatest_manual.html
==================================================================
--- docs/manual/megatest_manual.html
+++ docs/manual/megatest_manual.html
@@ -1,10 +1,10 @@
-
+
The Megatest Users Manual