Hello,
find attached two changes for the docs:
0001-Document-that-AT-AX-prints-nanoseconds.patch
The fact that -printf %AT shows nanoseconds was not mentioned
explicitely.
0002-Add-elaborate-on-warning-about-find-size-1M.patch
-size -1M only matching empty files causes support requests again and
again, expand doc a little bit.
cu Andreas
--
`What a good friend you are to him, Dr. Maturin. His other friends are
so grateful to you.'
`I sew his ears on from time to time, sure'
>From 6f10f15569dac6cbb9fda51fb88e39e9556f5d55 Mon Sep 17 00:00:00 2001
From: Andreas Metzler <ametz...@bebt.de>
Date: Thu, 31 Dec 2015 15:32:58 +0100
Subject: [PATCH 1/2] Document that %AT/%AX prints nanoseconds.
* doc/find.texi: Both %AT and %AX printf format specifiers print
nanoseconds since 4.3.3. - Document this.
* find/find.1: Likewise.
---
doc/find.texi | 5 +++--
find/find.1 | 5 +++--
2 files changed, 6 insertions(+), 4 deletions(-)
diff --git a/doc/find.texi b/doc/find.texi
index fdeb841..ea5600a 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -2063,9 +2063,10 @@ components.
@item r
time, 12-hour (hh:mm:ss [AP]M)
@item T
-time, 24-hour (hh:mm:ss)
+time, 24-hour (hh:mm:ss.xxxxxxxxxx)
@item X
-locale's time representation (H:M:S)
+locale's time representation (H:M:S). The seconds field includes a
+fractional part.
@item c
locale's date and time in ctime format (Sat Nov 04 12:02:33 EST
1989). This format does not include any fractional part in the
diff --git a/find/find.1 b/find/find.1
index 7b141b8..383ea83 100644
--- a/find/find.1
+++ b/find/find.1
@@ -1301,14 +1301,15 @@ time, 12-hour (hh:mm:ss [AP]M)
.IP S
Second (00.00 .. 61.00). There is a fractional part.
.IP T
-time, 24-hour (hh:mm:ss)
+time, 24-hour (hh:mm:ss.xxxxxxxxxx)
.IP +
Date and time, separated by `+', for example
`2004\-04\-28+22:22:05.0'. This is a GNU extension. The time is
given in the current timezone (which may be affected by setting the TZ
environment variable). The seconds field includes a fractional part.
.IP X
-locale's time representation (H:M:S)
+locale's time representation (H:M:S). The seconds field includes a
+fractional part.
.IP Z
time zone (e.g., EDT), or nothing if no time zone is determinable
.PP
--
2.6.4
>From 410bfa3cac91bc29c3cf288324e0f77e723de6f1 Mon Sep 17 00:00:00 2001
From: Andreas Metzler <ametz...@bebt.de>
Date: Thu, 31 Dec 2015 18:10:19 +0100
Subject: [PATCH 2/2] Add/elaborate on warning about find -size -1M.
* find/find.1: Elaborate on warning about find -size -1M.
* find.texi: Copy warning about find -size -1M from manpage.
---
doc/find.texi | 7 +++++--
find/find.1 | 12 ++++++++----
2 files changed, 13 insertions(+), 6 deletions(-)
diff --git a/doc/find.texi b/doc/find.texi
index ea5600a..1580b82 100644
--- a/doc/find.texi
+++ b/doc/find.texi
@@ -1034,8 +1034,11 @@ The number can be prefixed with a `+' or a `-'. A plus sign indicates
that the test should succeed if the file uses at least @var{n} units
of storage (a common use of this test) and a minus sign
indicates that the test should succeed if the file uses less than
-@var{n} units of storage. There is no `=' prefix, because that's the
-default anyway.
+@var{n} units of storage. Bear in mind that the size is rounded up to
+the next unit. Therefore @samp{-size -1M} is not equivalent to
+@samp{-size -1048576c}. The former only matches empty files, the latter
+matches files from 1 to 1,048,575 bytes. There is no `=' prefix, because
+that's the default anyway.
The size does not count indirect blocks, but it does count blocks in
sparse files that are not actually allocated. In other words, it's
diff --git a/find/find.1 b/find/find.1
index 383ea83..2f2c974 100644
--- a/find/find.1
+++ b/find/find.1
@@ -911,10 +911,14 @@ handle sparse files
differently. The `b' suffix always denotes 512-byte blocks and never
1 Kilobyte blocks, which is different to the behaviour of
.BR \-ls .
-The + and - prefixes signify greater than and less than, as usual,
-but bear in mind that the size is rounded up to the next unit (so a
-1-byte file is not matched by
-.BR "-size -1M" ).
+.IP
+The + and - prefixes signify greater than and less than, as usual.
+Bear in mind that the size is rounded up to the next unit. Therefore
+.BR "\-size \-1M"
+is not equivalent to
+.BR "\-size \-1048576c".
+The former only matches empty files, the latter matches files from 1 to
+1,048,575 bytes.
.IP \-true
Always true.
--
2.6.4
