@@ -274,10 +274,11 @@
 was historically called "itemwait" mode. The terms "itemwait" and
 "itemmatch" are synonyms.
 
 -------------------
 [requirements]
+waiton precedingtest
 mode itemmatch
 -------------------
 
 Overriding Enviroment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -297,17 +298,18 @@
 
 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
+itempath to the downstream test an itemmap can allow for itemwait/itemmatch
+mode by specifying rules on how to map the waiton's item name to the current test's item name.
 
 .example for removing part of itemmap for waiton test (eg: item +foo-x/bar+ depends on waiton's item +y/bar+)
 -------------------
 [requirements]
 mode itemwait
+waiton precedingtest
 # itemmap <item pattern for this test>  <item replacement pattern for waiton test>
 itemmap .*x/ y/
 
 -------------------
 
@@ -318,10 +320,11 @@
 #
 # ## Example
 # ## Remove everything up to the last /
 [requirements]
 mode itemwait
+waiton precedingtest
 # itemmap <item pattern for this test> <nothing here indicates removal>
 itemmap .*/
 -------------------
 
 .example replacing part of itemmap for (eg: item +foo/1234+ will imply waiton's item +bar/1234+)
@@ -330,10 +333,11 @@
 #
 # ## Example
 # ## Replace foo/ with bar/
 [requirements]
 mode itemwait
+waiton precedingtest
 # itemmap <item pattern for this test>  <item replacement pattern for waiton test>
 itemmap foo/ bar/
 
 -------------------
 
@@ -342,10 +346,11 @@
 #
 # ## Example
 # ## can use \{number} in replacement pattern to backreference a (capture) from matching pattern similar to sed or perl
 [requirements]
 mode itemwait
+waiton precedingtest
 # itemmap <item pattern for this test>  <item replacement pattern for waiton test>
 itemmap foo(\d+)/ num-\1/bar/
 
 -------------------
 
@@ -355,10 +360,12 @@
 # multi-line; matches are applied in the listed order
 # The following would map:
 #   a123b321 to b321fooa123 then to 321fooa123p
 #
 [requirements]
+modw itemwait
+waiton precedingtest
 itemmap (a\d+)(b\d+) \2foo\1
   b(.*) \1p
 -------------------
 
 
@@ -389,24 +396,27 @@
 
 .Testconfig for Test E has
 ----------------------
 [requirements]
 waiton C
+mode itemwait
 itemmap (\d+)/res \1/bb
 ----------------------
 
 .Testconfig for Test D has
 ----------------------
 [requirements]
 waiton C
+mode itemwait
 itemmap (\d+)/res \1/aa
 ----------------------
 
 .Testconfig for Test C has
 ----------------------
 [requirements]
 waiton A B
+mode itemwait
 
 [itemmap]
 A (\d+)/aa aa/\1
 B (\d+)/bb bb/\1
 ----------------------