Thanks for reporting the documentation problem. I installed the
attached, which isn't the same as the patch you suggested but which I
hope addresses the confusion concisely. Please let me know if it's still
confusing. Thanks.From b3cd2ee4aeaf01930c88ac6320afa347e74e91aa Mon Sep 17 00:00:00 2001
From: Paul Eggert <egg...@cs.ucla.edu>
Date: Fri, 9 Sep 2022 13:12:24 -0500
Subject: [PATCH] doc: improve GREP_COLORS doc (Bug#57696)
---
doc/grep.in.1 | 5 +++--
doc/grep.texi | 3 +--
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/doc/grep.in.1 b/doc/grep.in.1
index 0423866..5b3123d 100644
--- a/doc/grep.in.1
+++ b/doc/grep.in.1
@@ -1007,8 +1007,9 @@ The shell command
lists locales that are currently available.
.TP
.B GREP_COLORS
-Specifies the colors and other attributes
-used to highlight various parts of the output.
+Controls how the
+.B \-\^\-color
+option highlights output.
Its value is a colon-separated list of capabilities
that defaults to
.B ms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36
diff --git a/doc/grep.texi b/doc/grep.texi
index c371172..a8089cc 100644
--- a/doc/grep.texi
+++ b/doc/grep.texi
@@ -864,8 +864,7 @@ overridden by @env{GREP_COLORS}. Instead of
@item GREP_COLORS
@vindex GREP_COLORS @r{environment variable}
@cindex highlight markers
-This variable specifies the colors and other attributes
-used to highlight various parts of the output.
+This variable controls how the @option{--color} option highlights output.
Its value is a colon-separated list of @code{terminfo} capabilities
that defaults to @samp{ms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36}
with the @samp{rv} and @samp{ne} boolean capabilities omitted (i.e., false).
--
2.37.2