Index: docs/manual/howto.txt
==================================================================
--- docs/manual/howto.txt
+++ docs/manual/howto.txt
@@ -1,11 +1,14 @@
 
 How To Do Things
 ================
 
+Process Runs
+------------
+
 Remove Runs
------------
+~~~~~~~~~~~
 
 From the dashboard click on the button (PASS/FAIL...) for one of the tests. From the test control panel that 
 comes up push the clean test button. The command field will be prefilled with a template command for removing 
 that test. You can edit the command, for example change the argument to -testpatt to "%" to remove all tests.
 
@@ -18,30 +21,30 @@
 ----------------
 megatest -remove-runs -target %/%/% -runname % -testpatt % -v
 ----------------
 
 Archive Runs
-------------
+~~~~~~~~~~~~
 
 Megatest supports using the bup backup tool (https://bup.github.io/) to archive your tests for efficient storage
 and retrieval. Archived data can be rapidly retrieved if needed. The metadata for the run (PASS/FAIL status, run 
 durations, time stamps etc.) are all preserved in the megatest database.
 
 For setup information see the Archiving topic in the reference section of this manual.
 
 To Archive
-~~~~~~~~~~
+^^^^^^^^^^
 
 Hint: use the test control panel to create a template command by pushing the "Archive Tests" button.
 
 .Archive a full run
 ----------------
 megatest -target ubuntu/nfs/none -runname ww28.1a -archive save-remove -testpatt %
 ----------------
 
 To Restore
-~~~~~~~~~~
+^^^^^^^^^^
 
 .Retrieve a single test
 ----------------
 megatest -target ubuntu/nfs/none -runname ww28.1a -archive restore -testpatt diskperf/%
 ----------------
@@ -51,11 +54,11 @@
 ----------------
 bup -d /path/to/bup/archive ftp
 ----------------
 
 Submit jobs to Host Types based on Test Name
---------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .In megatest.config
 ------------------------
 [host-types]
 general ssh #{getbgesthost general}

Index: docs/manual/megatest_manual.html
==================================================================
--- docs/manual/megatest_manual.html
+++ docs/manual/megatest_manual.html
@@ -913,12 +913,14 @@
 </div>
 </div>
 </div>
 <h1 id="_how_to_do_things">How To Do Things</h1>
 <div class="sect1">
-<h2 id="_remove_runs">Remove Runs</h2>
+<h2 id="_process_runs">Process Runs</h2>
 <div class="sectionbody">
+<div class="sect2">
+<h3 id="_remove_runs">Remove Runs</h3>
 <div class="paragraph"><p>From the dashboard click on the button (PASS/FAIL&#8230;) for one of the tests. From the test control panel that
 comes up push the clean test button. The command field will be prefilled with a template command for removing
 that test. You can edit the command, for example change the argument to -testpatt to "%" to remove all tests.</p></div>
 <div class="listingblock">
 <div class="title">Remove the test diskperf and all it&#8217;s items</div>
@@ -929,29 +931,27 @@
 <div class="title">Remove all tests for all runs and all targets</div>
 <div class="content monospaced">
 <pre>megatest -remove-runs -target %/%/% -runname % -testpatt % -v</pre>
 </div></div>
 </div>
-</div>
-<div class="sect1">
-<h2 id="_archive_runs">Archive Runs</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_archive_runs">Archive Runs</h3>
 <div class="paragraph"><p>Megatest supports using the bup backup tool (<a href="https://bup.github.io/">https://bup.github.io/</a>) to archive your tests for efficient storage
 and retrieval. Archived data can be rapidly retrieved if needed. The metadata for the run (PASS/FAIL status, run
 durations, time stamps etc.) are all preserved in the megatest database.</p></div>
 <div class="paragraph"><p>For setup information see the Archiving topic in the reference section of this manual.</p></div>
-<div class="sect2">
-<h3 id="_to_archive">To Archive</h3>
+<div class="sect3">
+<h4 id="_to_archive">To Archive</h4>
 <div class="paragraph"><p>Hint: use the test control panel to create a template command by pushing the "Archive Tests" button.</p></div>
 <div class="listingblock">
 <div class="title">Archive a full run</div>
 <div class="content monospaced">
 <pre>megatest -target ubuntu/nfs/none -runname ww28.1a -archive save-remove -testpatt %</pre>
 </div></div>
 </div>
-<div class="sect2">
-<h3 id="_to_restore">To Restore</h3>
+<div class="sect3">
+<h4 id="_to_restore">To Restore</h4>
 <div class="listingblock">
 <div class="title">Retrieve a single test</div>
 <div class="content monospaced">
 <pre>megatest -target ubuntu/nfs/none -runname ww28.1a -archive restore -testpatt diskperf/%</pre>
 </div></div>
@@ -960,14 +960,12 @@
 <div class="content monospaced">
 <pre>bup -d /path/to/bup/archive ftp</pre>
 </div></div>
 </div>
 </div>
-</div>
-<div class="sect1">
-<h2 id="_submit_jobs_to_host_types_based_on_test_name">Submit jobs to Host Types based on Test Name</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_submit_jobs_to_host_types_based_on_test_name">Submit jobs to Host Types based on Test Name</h3>
 <div class="listingblock">
 <div class="title">In megatest.config</div>
 <div class="content monospaced">
 <pre>[host-types]
 general ssh #{getbgesthost general}
@@ -985,10 +983,11 @@
 launcher bsub
 # if defined and not "no" flexi-launcher will bypass launcher unless there is no
 # match.
 flexi-launcher yes</pre>
 </div></div>
+</div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_tricks">Tricks</h2>
 <div class="sectionbody">
@@ -1104,15 +1103,12 @@
 <div class="listingblock">
 <div class="content monospaced">
 <pre>[configf:settings trim-trailing-spaces yes]</pre>
 </div></div>
 </div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_submit_jobs_to_host_types_based_on_test_name_2">Submit jobs to Host Types based on Test Name</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_submit_jobs_to_host_types_based_on_test_name_2">Submit jobs to Host Types based on Test Name</h3>
 <div class="listingblock">
 <div class="title">In megatest.config</div>
 <div class="content monospaced">
 <pre>[host-types]
 general   nbfake
@@ -1126,26 +1122,27 @@
 launcher bsub
 # if defined and not "no" flexi-launcher will bypass launcher unless there is no
 # match.
 flexi-launcher yes</pre>
 </div></div>
-<div class="sect2">
-<h3 id="_host_types">host-types</h3>
+<div class="sect3">
+<h4 id="_host_types">host-types</h4>
 <div class="paragraph"><p>List of host types and the commandline to run a job on that host type.</p></div>
 <div class="listingblock">
 <div class="title">host-type &#8658; launch command</div>
 <div class="content monospaced">
 <pre>general nbfake</pre>
 </div></div>
 </div>
-<div class="sect2">
-<h3 id="_launchers">launchers</h3>
+<div class="sect3">
+<h4 id="_launchers">launchers</h4>
 <div class="listingblock">
 <div class="title">test/itempath &#8658; host-type</div>
 <div class="content monospaced">
 <pre>runfirst/sum% remote</pre>
 </div></div>
+</div>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_the_testconfig_file">The testconfig File</h2>

Index: docs/manual/reference.txt
==================================================================
--- docs/manual/reference.txt
+++ docs/manual/reference.txt
@@ -11,11 +11,11 @@
 ------------------
 [configf:settings trim-trailing-spaces yes]
 ------------------
 
 Submit jobs to Host Types based on Test Name
---------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .In megatest.config
 ------------------------
 [host-types]
 general   nbfake
@@ -31,21 +31,21 @@
 # match.
 flexi-launcher yes
 ------------------------
 
 host-types
-~~~~~~~~~~
+^^^^^^^^^^
 
 List of host types and the commandline to run a job on that host type.
 
 .host-type => launch command
 ------------
 general nbfake
 ------------
 
 launchers
-~~~~~~~~~
+^^^^^^^^^
 .test/itempath => host-type
 ------------
 runfirst/sum% remote
 ------------