Re: [PATCH] doc: Add missing actions from list that suppress default

Bernhard Voelker <[email protected]>
Newsgroups gmane.comp.gnu.findutils.bugs,gmane.comp.gnu.findutils.patches
Message-ID <[email protected]>
On 4/25/22 05:39, raf wrote:
> Hi, find/find.1 and doc/find.texi contain a list of the actions that
> suppress the default -print action. But -print0 and -fprint0 are missing
> from the list. This patch adds them to the list in both files.

Thanks - phew, time flies!

Meanwhile, the translators have suggested some man syntax fixes, so I adjusted
your patch accordingly.  I also took the liberty to sort the list of actions
alphabetically.

Okay to push?

Have a nice day,
Berny
0001-doc-supplement-list-of-actions-that-suppress-default.patch (text/x-patch, 2.4 KB)
From 15b14201cd411b0c1123d63e40047c21d5d566a0 Mon Sep 17 00:00:00 2001
From: raf <[email protected]>
Date: Mon, 25 Apr 2022 13:39:12 +1000
Subject: [PATCH] doc: supplement list of actions that suppress default -print

* find/find.1 (EXPRESSION): Add missing -print0 and -fprint0 to
the list of actions that suppress the default -print action.
Sort items.
* doc/find.texi (find Expressions): Likewise.
* NEWS: Mention the fix.
---
 NEWS          |  3 +++
 doc/find.texi | 19 +++++++++++++++----
 find/find.1   | 10 ++++++----
 3 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/NEWS b/NEWS
index 8aee5a3f..9d9472db 100644
--- a/NEWS
+++ b/NEWS
@@ -39,6 +39,9 @@ GNU findutils NEWS - User visible changes.      -*- outline -*- (allout)
 
   Translators contributed numerous fixes for issues in the find.1 man page.
 
+  The list of actions that suppress the default -print action has been
+  supplemented with the missing '-print0' and '-fprint0' actions.
+
 
 * Noteworthy changes in release 4.10.0 (2024-06-01) [stable]
 
diff --git a/doc/find.texi b/doc/find.texi
index a9b7c2fa..60d72ab7 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -328,10 +328,21 @@ connect primaries into more complex expressions.
 The @samp{-print} action is performed on all files for which the
 entire expression is true (@pxref{Print File Name}), unless the
 expression contains an action other than @samp{-prune} or
-@samp{-quit}. Actions which inhibit the default @samp{-print} are
-@samp{-delete}, @samp{-exec}, @samp{-execdir}, @samp{-ok},
-@samp{-okdir}, @samp{-fls}, @samp{-fprint}, @samp{-fprintf},
-@samp{-ls}, @samp{-print} and @samp{-printf}.
+@samp{-quit}.
+Actions which inhibit the default @samp{-print} are
+@samp{-delete},
+@samp{-execdir},
+@samp{-exec},
+@samp{-fls},
+@samp{-fprint0},
+@samp{-fprintf},
+@samp{-fprint},
+@samp{-ls},
+@samp{-okdir},
+@samp{-ok},
+@samp{-print0},
+@samp{-printf}
+and @samp{-print}.
 
 Options take effect immediately, rather than being evaluated for each
 file when their place in the expression is reached.  Therefore, for
diff --git a/find/find.1 b/find/find.1
index b43ff509..112b45bd 100644
--- a/find/find.1
+++ b/find/find.1
@@ -401,15 +401,17 @@ are
 .BR \-delete ,
 .BR \-exec ,
 .BR \-execdir ,
-.BR \-ok ,
-.BR \-okdir ,
 .BR \-fls ,
 .BR \-fprint ,
+.BR \-fprint0 ,
 .BR \-fprintf ,
 .BR \-ls ,
-.B \-print
+.BR \-ok ,
+.BR \-okdir ,
+.BR \-print0 ,
+.B \-printf
 and
-.BR \-printf .
+.BR \-print .
 
 
 The
-- 
2.48.1
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.