Index: docs/manual/megatest_manual.txt
==================================================================
--- docs/manual/megatest_manual.txt
+++ docs/manual/megatest_manual.txt
@@ -63,17 +63,25 @@
 
 include::getting_started.txt[] include::writing_tests.txt[]
 include::reference.txt[]
 
 
+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
+
+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)
+
 =========================================================
-# logpro_file  input_glob
+###### 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
 #
 [waivers]
-waiver_1 logpro lookittmp.log
+# logpro_file    rulename      input_glob
+waiver_1         logpro        lookittmp.log
 
 [waiver_rules]
 
 # This builtin rule is the default if there is no <waivername>.logpro file
 # diff   diff %file1% %file2%