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