summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2017-02-26 20:29:37 -0800
committerKaz Kylheku <kaz@kylheku.com>2017-02-26 20:29:37 -0800
commitf4f0ac8e53dda991a47b018ad1bbfbff47e541fa (patch)
treef1b9a4926654caf02499a88afd4c6940a8ff1c7f /txr.1
parent93b63a18346d62fd68aae5802b9439f7964043a2 (diff)
downloadtxr-f4f0ac8e53dda991a47b018ad1bbfbff47e541fa.tar.gz
txr-f4f0ac8e53dda991a47b018ad1bbfbff47e541fa.tar.bz2
txr-f4f0ac8e53dda991a47b018ad1bbfbff47e541fa.zip
doc: horizontal trailer.
* txr.1: Add missing documentation of the existence of horizontal @(trailer) syntax.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.126
1 files changed, 26 insertions, 0 deletions
diff --git a/txr.1 b/txr.1
index 34289dd4..e1dd2ab7 100644
--- a/txr.1
+++ b/txr.1
@@ -3908,6 +3908,32 @@ cause
.code @(collect)
to match partially overlapping regions.
+Trailer can be used in vertical context:
+
+.cblk
+.mets @(trailer)
+.mets < directives
+.mets ...
+.cble
+
+or horizontal:
+
+.cblk
+.mets @(trailer) < directives ...
+.cble
+
+A vertical
+.code trailer
+prevents the vertical input position from
+advancing as it is matched by
+.metn directives ,
+whereas a horizontal
+.code trailer
+prevents the horizontal position from advancing. In other words,
+.code trailer
+performs matching without consuming the input, providing a
+look-ahead mechanism.
+
Example:
.cblk