From f4f0ac8e53dda991a47b018ad1bbfbff47e541fa Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Sun, 26 Feb 2017 20:29:37 -0800
Subject: doc: horizontal trailer.

* txr.1: Add missing documentation of the existence of
horizontal @(trailer) syntax.
---
 txr.1 | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

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
-- 
cgit v1.2.3