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

Reply via email to