@@ -627,14 +627,20 @@
 basis.
 
 Controlled waiver propagation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If test is FAIL and previous test in run with same MT_TARGET is WAIVED then apply the following rules from the testconfig:
-If a waiver check is specified in the testconfig apply the check and if it passes then set this FAIL to WAIVED
+If test is FAIL and previous test in run with same MT_TARGET is WAIVED
+or if the test/itempath is listed under the matching target in the
+waivers roll forward file (see below for file spec) then apply the
+following rules from the testconfig: If a waiver check is specified in
+the testconfig apply the check and if it passes then set this FAIL to
+WAIVED
 
-Waiver check has two parts, 1) a list of waiver, rulename, filepatterns and 2) the rulename script spec (note that "diff" and "logpro" are predefined)
+Waiver check has two parts, 1) a list of waiver, rulename,
+filepatterns and 2) the rulename script spec (note that "diff" and
+"logpro" are predefined)
 
 -----------------
 ###### EXAMPLE FROM testconfig #########
 # matching file(s) will be diff'd with previous run and logpro applied
 # if PASS or WARN result from logpro then WAIVER state is set
@@ -650,10 +656,37 @@
 
 # This builtin rule is applied if a <waivername>.logpro file exists
 # logpro diff %file1% %file2% | logpro %waivername%.logpro %waivername%.html
 -----------------
 
+Waiver roll-forward files
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To transfer waivers from one Megatest area to another it is possible
+to dump waivers into a file and reference that file in another area.
+
+.Dumping the waivers
+---------------------------
+megatest -list-waivers -runname %-a > mywaivers.dat
+---------------------------
+
+.Referencing the saved waivers
+---------------------------
+# In megatest.config, all files listed will be loaded - recomended to use
+# variables to select directorys to minimize what gets loaded.
+[setup]
+waivers-dirs /path/to/waiver/files /another/path/to/waiver/files
+---------------------------
+
+.Waiver files format
+---------------------------
+[the/target/here]
+# comments are fine
+testname1/itempath A comment about why it was waived
+testname2          A comment for a non-itemized test 
+---------------------------
+
 Ezsteps
 ~~~~~~~
 
 .Example ezsteps with logpro rules
 -----------------