Subject: grep: Document --group-separator/--no-group-separator
From: Kevin Locke <[email-masked]>
To: [email-masked]
Date: Fri, 16 Apr 2021 18:14:23 -0600
List-Id: <debbugs-submit.debbugs.gnu.org>

Severity: minor
Tags: patch

Dear Maintainer,

It would be great if the grep.1 man page and --help usage information
included the --group-separator and --no-group-separator options (which
are already documented in grep.texi).  I've attached patches to do that.

Thanks,
Kevin
From 20053444457c5b4d9b0855a5d06a817272b78de7 Mon Sep 17 00:00:00 2001
Message-Id: <[email-masked]>
From: Kevin Locke <[email-masked]>
Date: Fri, 16 Apr 2021 16:30:16 -0600
Subject: [PATCH 1/2] doc: man: add --group-separator/--no-group-separator

* doc/grep.in.1:
  Add copy of docs for --group-separator from doc/grep.texi.
  Add copy of docs for --no-group-separator from doc/grep.texi.
---
 doc/grep.in.1 | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/grep.in.1 b/doc/grep.in.1
index c0b6b405..77c2e0ab 100644
--- a/doc/grep.in.1
+++ b/doc/grep.in.1
@@ -482,6 +482,26 @@ With the
 or
 .B \-\^\-only\-matching
 option, this has no effect and a warning is given.
+.TP
+.BI \-\^\-group\-separator= SEP
+When
+.BR \-A ,
+.BR \-B ,
+or
+.B \-C
+are in use, print
+.I SEP
+instead of
+.B \-\^\-
+between groups of lines.
+.TP
+.B \-\^\-no\-group\-separator
+When
+.BR \-A ,
+.BR \-B ,
+or
+.B \-C
+are in use, do not print a separator between groups of lines.
 .SS "File and Directory Selection"
 .TP
 .BR \-a ", " \-\^\-text
-- 
2.30.2

From c1cb88a181994b524955d4fcfc5c66ea5d3ae3f8 Mon Sep 17 00:00:00 2001
Message-Id: <[email-masked]>
In-Reply-To: <[email-masked]>
References: <[email-masked]>
From: Kevin Locke <[email-masked]>
Date: Fri, 16 Apr 2021 18:07:19 -0600
Subject: [PATCH 2/2] doc: usage: --group-separator/--no-group-separator

* src/grep.c (usage):
  Add --group-separator to --help usage message.
  Add --no-group-separator to --help usage message.
---
 src/grep.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/grep.c b/src/grep.c
index d27d79e5..04768275 100644
--- a/src/grep.c
+++ b/src/grep.c
@@ -2048,6 +2048,8 @@ Context control:\n\
 "));
       printf (_("\
   -NUM                      same as --context=NUM\n\
+      --group-separator=SEP print SEP on line between matches with context\n\
+      --no-group-separator  do not print separator for matches with context\n\
       --color[=WHEN],\n\
       --colour[=WHEN]       use markers to highlight the matching strings;\n\
                             WHEN is 'always', 'never', or 'auto'\n\
-- 
2.30.2