aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2024-01-16 22:05:17 +0100
committerThomas Voss <mail@thomasvoss.com> 2024-01-16 22:05:17 +0100
commitf5a25fdde7190905dd5e3d2b21cb042d0aa7ce7b (patch)
treec14549ed813d9ebed0d60d1201150c9298f13b5e
parenta750426dae1870da54442763e272e78f6856db7d (diff)
Document the new color configuration
-rw-r--r--man/grab.135
1 files changed, 21 insertions, 14 deletions
diff --git a/man/grab.1 b/man/grab.1
index 76e62bd..1a4ab53 100644
--- a/man/grab.1
+++ b/man/grab.1
@@ -150,14 +150,27 @@ As you may use whichever delimiter you like, the following is also valid:
.Pp
.Dl x|[0-9]+| g.3. v#^1337#
.Sh ENVIRONMENT
-.Bl -tag -width GRAB_COLOR_FNAME
-.It Ev GRAB_COLOR_FNAME
-The color(s) with which to highlight filenames,
-or 35 if unset.
-.It Ev GRAB_COLOR_SEPC
-The color(s) with which to highlight the colon-separator between
-filenames and matches,
-or 36 if unset.
+.Bl -tag -width GRAB_COLORS
+.It Ev GRAB_COLORS
+A comma-separated list of color options in the form
+.Sq key=val .
+The value specified by
+.Ar val
+must be a SGR parameter.
+For more information see
+.Sx "SEE ALSO" .
+.Pp
+The keys are as follows:
+.Pp
+.Bl -tag -compact
+.It fn
+filenames prefixing any content line.
+.It se
+separators inserted between filenames and content lines.
+.El
+.Pp
+The default value is
+.Sq fn=35,se=36
.It Ev NO_COLOR
Do not display any colored output when set to a non-empty string,
even if the standard-output is a terminal.
@@ -169,12 +182,6 @@ even when the
.Fl c
option is provided.
.El
-.Pp
-The
-.Ev GRAB_COLOR_*
-environment variables are SGR parameters.
-For more information regarding SGR parameters see
-.Sx SEE ALSO .
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES