I pushed the attached patch, it's straightforward, mainly formatting for
easier understanding of the order of changes.
From 580be65e2566a90c6029e994dce4b22ddd42806c Mon Sep 17 00:00:00 2001
From: James Youngman <[email protected]>
Date: Tue, 18 Nov 2025 09:49:21 +0000
Subject: [PATCH] [find] Format findutils changes as reverse-time-ordered
tables.
* find/find.1 (COMPATIBILITY): Add release-year information to the
feature addition table. Format the functional changes as a table,
too.
---
find/find.1 | 116 ++++++++++++++++++++++++++++------------------------
1 file changed, 63 insertions(+), 53 deletions(-)
diff --git a/find/find.1 b/find/find.1
index d2a11166..70c0de64 100644
--- a/find/find.1
+++ b/find/find.1
@@ -2001,7 +2001,7 @@ This option is supported.
This option is supported, but POSIX conformance depends on the
POSIX conformance of the system's
.BR fnmatch (3)
-library function. As of findutils-4.2.2, shell metacharacters
+library function. As of findutils-4.2.2 (2004), shell metacharacters
(`*', `?' or `[]' for example) match a leading `.', because
IEEE PASC interpretation 126 requires this.
This is a change from previous versions of findutils.
@@ -2689,18 +2689,54 @@ and
came from Dan Bernstein.
.
.SH COMPATIBILITY
-As of findutils-4.2.2, shell metacharacters (`*', `?' or `[]' for
-example) used in filename patterns match a leading `.', because
-IEEE POSIX interpretation 126 requires this.
-.P
-As of findutils-4.3.3,
-.B \-perm\ /000
-now matches all files instead of none.
-.P
-Nanosecond-resolution
-timestamps were implemented in findutils-4.3.3.
-.P
-As of findutils-4.3.11, the
+.SS Feature Additions
+.TS
+l l l l .
+Feature Added in Year Also occurs in
+\-files0\-from 4.9.0 2022
+\-newerXY 4.3.3 2007 BSD
+\-D 4.3.1 2006
+\-O 4.3.1 2006
+\-readable 4.3.0 2005
+\-writable 4.3.0 2005
+\-executable 4.3.0 2005
+\-regextype 4.2.24 2004
+\-exec ...\& + 4.2.12 2005 POSIX
+\-execdir 4.2.12 2005 BSD
+\-okdir 4.2.12 2005
+\-samefile 4.2.11 2004
+\-H 4.2.5 2004 POSIX
+\-L 4.2.5 2004 POSIX
+\-P 4.2.5 2004 BSD
+\-delete 4.2.3 2004
+\-quit 4.2.3 2004
+\-d 4.2.3 2004 BSD
+\-wholename 4.2.0 2003
+\-iwholename 4.2.0 2003
+\-ignore_readdir_race 4.2.0 2003
+\-fls 4.0 1994
+\-ilname 3.8 1993
+\-iname 3.8 1993 POSIX (from Issue 8, IEEE Std 1003.1\-2024)
+\-ipath 3.8 1993
+\-iregex 3.8 1993
+\-print0 2.0 1990 POSIX (from Issue 8, IEEE Std 1003.1\-2024)
+.TE
+.SS Functional Changes
+.TS
+l l lx .
+Version Year Change
+4.5.12 2013 T{
+The syntax
+.B \-perm +MODE
+is removed, in favour of
+.B \-perm
+.BR /MODE .
+The
+.B +MODE
+syntax had been deprecated since findutils-4.2.21 (2005).
+T}
+4.3.11 2007 T{
+The
.B \-delete
action sets
.BR find 's
@@ -2711,48 +2747,22 @@ will not exit immediately. Previously,
.BR find 's
exit status was unaffected by the failure of
.BR \-delete .
-
-.TS
-l l l .
-Feature Added in Also occurs in
-\-files0\-from 4.9.0
-\-newerXY 4.3.3 BSD
-\-D 4.3.1
-\-O 4.3.1
-\-readable 4.3.0
-\-writable 4.3.0
-\-executable 4.3.0
-\-regextype 4.2.24
-\-exec ...\& + 4.2.12 POSIX
-\-execdir 4.2.12 BSD
-\-okdir 4.2.12
-\-samefile 4.2.11
-\-H 4.2.5 POSIX
-\-L 4.2.5 POSIX
-\-P 4.2.5 BSD
-\-delete 4.2.3
-\-quit 4.2.3
-\-d 4.2.3 BSD
-\-wholename 4.2.0
-\-iwholename 4.2.0
-\-ignore_readdir_race 4.2.0
-\-fls 4.0
-\-ilname 3.8
-\-iname 3.8 POSIX (from Issue 8, IEEE Std 1003.1\-2024)
-\-ipath 3.8
-\-iregex 3.8
-\-print0 2.0 POSIX (from Issue 8, IEEE Std 1003.1\-2024)
+T}
+4.3.3 2007 T{
+Nanosecond-resolution timestamps; seconds fields are
+no longer integers.
+T}
+4.3.3 2007 T{
+.B \-perm\ /000
+now matches all files instead of none.
+T}
+4.2.2 2004 T{
+Shell metacharacters (`*', `?' or `[]' for example) used in filename
+patterns match a leading `.', because IEEE POSIX interpretation 126
+requires this.
+T}
.TE
.P
-The syntax
-.B \-perm +MODE
-was removed in findutils-4.5.12, in favour of
-.B \-perm
-.BR /MODE .
-The
-.B +MODE
-syntax had been deprecated since findutils-4.2.21
-which was released in 2005.
.
.SH NON-BUGS
.SS Operator precedence surprises
--
2.39.5
