rpms/findutils
7
0
Fork 0
Code Issues Pull Requests Releases Activity

improve description of printf options in find manpage

Browse Source 
Resolves: #1882695
This commit is contained in:
Lukáš Zaoral 2023-08-21 12:08:00 +02:00
parent d1e7235ecd
commit 09cd4d5937
No known key found for this signature in database
GPG Key ID: 39157506DD67752D
2 changed files with 87 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

80
findutils-4.6.0-improve-printf-Ak-description.patch Normal file
View File

@ -0,0 +1,80 @@
From efa455493063270406f3c206d62032a475e52c47 Mon Sep 17 00:00:00 2001
From: Kamil Dudka <kdudka@redhat.com>
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 <lzaoral@redhat.com>
---
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

8
findutils.spec
View File

@ -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 <lzaoral@redhat.com> - 1:4.6.0-22
- improve description of printf options in find manpage (#1882695)
* Wed Aug 16 2023 Lukáš Zaoral <lzaoral@redhat.com> - 1:4.6.0-21
- fix find not obeying option -ignore_readdir_race in symlink_loop (#2232278)