Index: docs/manual/megatest_manual.html
==================================================================
--- docs/manual/megatest_manual.html
+++ docs/manual/megatest_manual.html
@@ -1218,12 +1218,13 @@
 <div class="content monospaced">
 <pre>[requirements]
 mode itemmatch</pre>
 </div></div>
 </div>
-<div class="sect3">
-<h4 id="_itemmap">Itemmap</h4>
+</div>
+<div class="sect2">
+<h3 id="_itemmap_handling">Itemmap Handling</h3>
 <div class="paragraph"><p>For cases were the dependent test has a similar but not identical
 itempath to the downstream test an itemmap can allow for itemmatch
 mode</p></div>
 <div class="listingblock">
 <div class="content monospaced">
@@ -1246,11 +1247,10 @@
 #   a123b321 to b321fooa123 then to 321fooa123p
 #
 itemmap (a\d+)(b\d+) \2foo\1
   b(.*) \1p</pre>
 </div></div>
-</div>
 <div class="sect3">
 <h4 id="_complex_mappings">Complex mappings</h4>
 <div class="paragraph"><p>Complex mappings can be handled with the [itemmap] section</p></div>
 <div class="imageblock">
 <div class="content">
@@ -1264,21 +1264,21 @@
 Request to run D/1/res
 </p>
 </li>
 <li>
 <p>
-Megatest calculates all posible items for Test C and filters down to: C/1/aa
+Megatest uses rule "(\d+)/res" &#8594; "\1/aa" to create item C/1/aa from D/1/res
 </p>
 </li>
 <li>
 <p>
 Full list to be run is now: D/1/res, C/1/aa
 </p>
 </li>
 <li>
 <p>
-Megatest calculates all posible items for Test A and filters down to: A/aa/1
+Megatest uses rule "(\d+)/aa" &#8594; "aa/\1" to create item A/aa/1
 </p>
 </li>
 <li>
 <p>
 Full list to be run is now: D/1/res, C/1/aa, A/aa/1

Index: docs/manual/reference.txt
==================================================================
--- docs/manual/reference.txt
+++ docs/manual/reference.txt
@@ -133,12 +133,12 @@
 -------------------
 [requirements]
 mode itemmatch
 -------------------
 
-Itemmap
-^^^^^^^
+Itemmap Handling
+~~~~~~~~~~~~~~~~
 
 For cases were the dependent test has a similar but not identical
 itempath to the downstream test an itemmap can allow for itemmatch
 mode
 
@@ -174,13 +174,13 @@
 image::complex-itemmap.png[]
 
 Example:
 
 . Request to run D/1/res
-. Megatest calculates all posible items for Test C and filters down to: C/1/aa
+. Megatest uses rule "(\d+)/res" -> "\1/aa" to create item C/1/aa from D/1/res
 . Full list to be run is now: D/1/res, C/1/aa
-. Megatest calculates all posible items for Test A and filters down to: A/aa/1
+. Megatest uses rule "(\d+)/aa" -> "aa/\1" to create item A/aa/1
 . Full list to be run is now: D/1/res, C/1/aa, A/aa/1
 
 .Testconfig for Test C
 ----------------------
 [requirements]