diff --git a/SOURCES/findutils-4.6.0-improve-printf-Ak-description.patch b/SOURCES/findutils-4.6.0-improve-printf-Ak-description.patch new file mode 100644 index 0000000..44fca07 --- /dev/null +++ b/SOURCES/findutils-4.6.0-improve-printf-Ak-description.patch @@ -0,0 +1,80 @@ +From efa455493063270406f3c206d62032a475e52c47 Mon Sep 17 00:00:00 2001 +From: Kamil Dudka +Date: Tue, 6 Oct 2020 17:10:08 +0200 +Subject: [PATCH] doc: avoid misunderstanding of '-printf %Ak' description + +* find/find.1 (-printf): Make it clear that the list of conversion +specification characters of '%Ak' is incomplete; refer to the +strftime() documentation. While at it, document the F conversion +character which yields 'yyyy-mm-dd'. +* doc/find.texi (Time Formats): Likewise. + +Suggested in https://bugzilla.redhat.com/1882695 + +Cherry-picked-by: Lukáš Zaoral +--- + doc/find.texi | 11 +++++++---- + find/find.1 | 9 ++++++--- + 2 files changed, 13 insertions(+), 7 deletions(-) + +diff --git a/doc/find.texi b/doc/find.texi +index ce63ca52..0d7c8ae8 100644 +--- a/doc/find.texi ++++ b/doc/find.texi +@@ -2063,10 +2063,11 @@ behaviour, because other directives may be added in the future. + @node Time Formats + @subsection Time Formats + +-Below are the formats for the directives @samp{%A}, @samp{%C}, and +-@samp{%T}, which print the file's timestamps. Some of these formats +-might not be available on all systems, due to differences in the C +-@code{strftime} function between systems. ++Below is an incomplete list of formats for the directives @samp{%A}, @samp{%C}, ++and @samp{%T}, which print the file's timestamps. ++Please refer to the documentation of @code{strftime} for the full list. ++Some of these formats might not be available on all systems, due to differences ++in the implementation of the C @code{strftime} function. + + @menu + * Time Components:: +@@ -2162,6 +2163,8 @@ locale's date and time in ctime format (Sat Nov 04 12:02:33 EST + seconds field. + @item D + date (mm/dd/yy) ++@item F ++date (yyyy-mm-dd) + @item x + locale's date representation (mm/dd/yy) + @item + +diff --git a/find/find.1 b/find/find.1 +index ee7c6842..27ec62cd 100644 +--- a/find/find.1 ++++ b/find/find.1 +@@ -1420,10 +1420,11 @@ + File's last access time in the format returned by the C `ctime' function. + .IP %A\fIk\fP + File's last access time in the format specified by \fIk\fR, which is +-either `@' or a directive for the C `strftime' function. The possible +-values for \fIk\fR are listed below; some of them might not be +-available on all systems, due to differences in `strftime' between +-systems. ++either `@' or a directive for the C `strftime' function. The following ++shows an incomplete list of possible values for \fIk\fR. ++Please refer to the documentation of `strftime' for the full list. ++Some of the conversion specification characters might not be available on all systems, ++due to differences in the implementation of the `strftime' library function. + .RS + .IP @ + seconds since Jan.\& 1, 1970, 00:00 GMT, with fractional part. +@@ -1476,6 +1477,8 @@ in the seconds field. + day of month (01..31) + .IP D + date (mm/dd/yy) ++.IP F ++date (yyyy-mm-dd) + .IP h + same as b + .IP j +-- +2.41.0 + diff --git a/SPECS/findutils.spec b/SPECS/findutils.spec index 809379b..c5bb488 100644 --- a/SPECS/findutils.spec +++ b/SPECS/findutils.spec @@ -1,7 +1,7 @@ Summary: The GNU versions of find utilities (find and xargs) Name: findutils Version: 4.6.0 -Release: 21%{?dist} +Release: 22%{?dist} Epoch: 1 License: GPLv3+ Group: Applications/File @@ -52,6 +52,9 @@ Patch13: findutils-4.6.0-covscan.patch # fix find not obeying option -ignore_readdir_race in symlink_loop (#2232278) Patch14: findutils-4.6.0-ignore_readdir_race-symlink_loop.patch +# manpage of find is incomplete regarding printf options (#1882695) +Patch15: findutils-4.6.0-improve-printf-Ak-description.patch + Requires(post): /sbin/install-info Requires(preun): /sbin/install-info Conflicts: filesystem < 3 @@ -153,6 +156,9 @@ fi %{_infodir}/find-maint.info.gz %changelog +* Mon Aug 21 2023 Lukáš Zaoral - 1:4.6.0-22 +- improve description of printf options in find manpage (#1882695) + * Wed Aug 16 2023 Lukáš Zaoral - 1:4.6.0-21 - fix find not obeying option -ignore_readdir_race in symlink_loop (#2232278)