From cb9b9ac3de7c47b303398dcf6458aa443caf349c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Ankarstr=C3=B6m?= Date: Mon, 28 Jun 2021 19:00:02 +0200 Subject: README.t: Document 'list' utility --- README.t | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) (limited to 'README.t') 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.) -- cgit v1.2.3