diff -r cd3068704d3a -r c98e93d9a07f doc/loupe-test.txt
--- a/doc/loupe-test.txt	Sun Oct 20 21:06:25 2013 +0100
+++ b/doc/loupe-test.txt	Sat Nov 02 09:05:10 2013 +0000
@@ -30,6 +30,13 @@
 C:\DP> set BOOKLOUPE=C:\GUTCHECK\GUTCHECK.EXE
 C:\DP> loupe-test *.tst
 
+When a testcase fails, loupe-test shows the output of bookloupe (or gutcheck)
+up until the point where it deviates from the expected result and displays a
+carat (^) to point to the exact column where the deviation occurred. Sometimes
+it can still be difficult to work out what is happening and so loupe-test also
+supports a -o option which will simply print bookloupe's output without comment
+or checking.
+
 Writing your own testcases
 --------------------------
 
@@ -163,6 +170,24 @@
        │    Line 3 column 29 - Query possible scanno arid              │
        └───────────────────────────────────────────────────────────────┘
 
+Non standard output
+-------------------
+
+Bookloupe normally follows a standard pattern when printing warnings which
+loupe-test knows how to interpret. Occasionally this is not suitable and
+the testcase needs to specify exactly what should be printed. This can
+be done by adding a literal stdout to the EXPECTED tag:
+
+       ┌───────────────────────────────────────────────────────────────┐
+       │**************** OPTIONS ****************                      │
+       │--dump-config                                                  │
+       │**************** EXPECTED(stdout) ****************             │
+       │# Trivial configuration                                        │
+       │                                                               │
+       │[options]                                                      │
+       │dp=true                                                        │
+       └───────────────────────────────────────────────────────────────┘
+
 False-positives
 ---------------