From 167d40913908562af9e38f233481cbc528f9a904 Mon Sep 17 00:00:00 2001
From: Thomas Voss <mail@thomasvoss.com>
Date: Mon, 22 Jan 2024 20:04:50 +0100
Subject: Document the behavior of an empty h//

---
 man/grab.1 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'man')

diff --git a/man/grab.1 b/man/grab.1
index e2f90c6..1104e20 100644
--- a/man/grab.1
+++ b/man/grab.1
@@ -209,6 +209,23 @@ filters out the specific number 1337.
 As you may use whichever delimiter you like, the following is also valid:
 .Pp
 .Dl x|[0\-9]+| g.3. G#^1337#
+.Pp
+Operators are not allowed to take empty regular expression arguments with
+one exception:
+.Sq h .
+When given an empty regular expression argument,
+the
+.Sq h
+operator assumes the same regular expression as the previous operator.
+This allows you to avoid duplication in the common case where a user
+wishes to highlight text matched by a
+.Sq g
+operator.
+The following example pattern selects all words that have a capital
+letter,
+and highlights the capital letter(s):
+.Pp
+.Dl x/\ew+/ g/[A\-Z]/ h//
 .Sh ENVIRONMENT
 .Bl -tag -width GRAB_COLORS
 .It Ev GRAB_COLORS
-- 
cgit v1.2.3