Index: docs/manual/debugging.txt
==================================================================
--- docs/manual/debugging.txt
+++ docs/manual/debugging.txt
@@ -247,11 +247,11 @@
 ..............................
 
 Misc Other Debugging Hints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Annotation scripts and config files
+Annotating scripts and config files
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Run the "env" command to record the environment:
 
 env | sort > stagename.log
@@ -265,26 +265,30 @@
 # or
 
 [system env | sort > stagename.log}
 ...................
 
-In scripts just insert the command:
+In scripts just insert the commands, this example helps you identify
+if "some commands ..." changed any environment variables.:
+
+.myscript.sh
+..............................
+env > somefile-before.log
+some commands ...
+env > somefile-after.log
+..............................
 
-.myscript.sh
+.Use meld to examine the differences
 ..............................
-env > somefile.log
+meld somefile-before.log somefile-after.log
 ..............................
 
 Start an xterm to examine the environment, run scripts etc:
 
 In a config file:
 
 .megatest.config, runconfigs.config and testconfig files
 ..............................
 #{shell xterm}  (this blocks)
-
-or
-
-#{shell xterm &} (this is non-blocking)
 ..............................
 
 Similarly in a script just call the xterm.

Index: docs/manual/megatest_manual.html
==================================================================
--- docs/manual/megatest_manual.html
+++ docs/manual/megatest_manual.html
@@ -2189,11 +2189,11 @@
 </div>
 </div>
 <div class="sect2">
 <h3 id="_misc_other_debugging_hints">Misc Other Debugging Hints</h3>
 <div class="sect3">
-<h4 id="_annotation_scripts_and_config_files">Annotation scripts and config files</h4>
+<h4 id="_annotating_scripts_and_config_files">Annotating scripts and config files</h4>
 <div class="paragraph"><p>Run the "env" command to record the environment:</p></div>
 <div class="paragraph"><p>env | sort &gt; stagename.log</p></div>
 <div class="paragraph"><p>In a config file:</p></div>
 <div class="literalblock">
 <div class="title">megatest.config, runconfigs.config and testconfig</div>
@@ -2202,26 +2202,30 @@
 
 # or
 
 [system env | sort &gt; stagename.log}</pre>
 </div></div>
-<div class="paragraph"><p>In scripts just insert the command:</p></div>
+<div class="paragraph"><p>In scripts just insert the commands, this example helps you identify
+if "some commands &#8230;" changed any environment variables.:</p></div>
 <div class="literalblock">
 <div class="title">myscript.sh</div>
 <div class="content monospaced">
-<pre>env &gt; somefile.log</pre>
+<pre>env &gt; somefile-before.log
+some commands ...
+env &gt; somefile-after.log</pre>
+</div></div>
+<div class="literalblock">
+<div class="title">Use meld to examine the differences</div>
+<div class="content monospaced">
+<pre>meld somefile-before.log somefile-after.log</pre>
 </div></div>
 <div class="paragraph"><p>Start an xterm to examine the environment, run scripts etc:</p></div>
 <div class="paragraph"><p>In a config file:</p></div>
 <div class="literalblock">
 <div class="title">megatest.config, runconfigs.config and testconfig files</div>
 <div class="content monospaced">
-<pre>#{shell xterm}  (this blocks)
-
-or
-
-#{shell xterm &amp;} (this is non-blocking)</pre>
+<pre>#{shell xterm}  (this blocks)</pre>
 </div></div>
 <div class="paragraph"><p>Similarly in a script just call the xterm.</p></div>
 </div>
 </div>
 </div>

Index: docs/manual/megatest_manual.pdf
==================================================================
--- docs/manual/megatest_manual.pdf
+++ docs/manual/megatest_manual.pdf
cannot compute difference between binary files