README.t: Document 'list' utility

1 files changed, 28 insertions, 0 deletions

diff --git a/README.t b/README.t
index f49637a..3c6c2be 100644
--- a/README.t
+++ b/README.t
@@ -834,3 +834,31 @@ See page \n[&refname].
 .l)
 .p
 (I prefer prefixing my references with an ampersand.)
+.
+.se How do I include source code without needing to escape it?
+.p
+The
+.i µ
+distribution includes a troff preprocessor called
+.i list ,
+which filters text delimited by
+.c .l(
+and
+.c .l) ,
+escaping standard troff syntax.
+.p
+To automatically add a
+.c .l
+request before each listing, set the
+.i -p
+(prefix) flag accordingly:
+.l(
+list -p.l
+.l)
+.p
+To transparently pass an input line to troff,
+prefix it with
+.c \\\\! .
+(To disable this behavior, use the
+.i -E
+flag.)