From 6dfd05ca58e42ada04780f2f74383c6e54bcabba Mon Sep 17 00:00:00 2001 From: Bernhard Voelker Date: Thu, 13 Apr 2017 08:41:20 +0200 Subject: [PATCH] doc: fix some -perm examples in find.info * doc/find.texi (Mode Bits): Fix the description of the -perm examples which search for the "022" mode bits: the match is for the file's group and 'other' mode bits instead of for user and group. While at it, remove a superfluous ';' in the adjacent example. Bug introduced when adding the -perm examples in FINDUTILS-4.2.11. * NEWS: Mention the fix. Reported by Jacob Nevins <0jacobnk.gnu@chiark.greenend.org.uk> in http://savannah.gnu.org/bugs/?50758 --- NEWS | 9 +++++++++ doc/find.texi | 11 +++++------ 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/NEWS b/NEWS index 6f2ca4e4..3dd230dc 100644 --- a/NEWS +++ b/NEWS @@ -35,8 +35,17 @@ of the - yet more portable - '( -type l -o -type d )'. find now diagnoses failures returned by readdir(). This bug was inherent in the use of FTS. +** Documentation Changes + +Some minor documentation improvements are listed in "Bug Fixes" below. + ** Bug Fixes +#50758: doc: fix the description of the -perm examples matching the permission + mode "022" in find's texinfo manual: the match is for the file's group + and 'other' mode bits instead of for user and group. + Bug introduced when adding the -perm examples in FINDUTILS-4.2.11. + #50326: find no longer leaks memory for a recently added member in gnulib's mount list structure. diff --git a/doc/find.texi b/doc/find.texi index 401b7139..24d8ef99 100644 --- a/doc/find.texi +++ b/doc/find.texi @@ -1239,9 +1239,9 @@ Match files that are writable by somebody (their owner, or their group, or anybody else). @item -perm /022 -Match files that are writable by either their owner or their -group. The files don't have to be writable by both the owner and -group to be matched; either will do. +Match files that are writable by their group or everyone else - the latter +often called @dfn{other}. The files don't have to be writable by both the +group and other to be matched; either will do. @item -perm /g+w,o+w As above. @@ -1250,14 +1250,13 @@ As above. As above. @item -perm -022 -Match files that are writable by both their owner and their -group. +Match files that are writable by both their group and everyone else. @item -perm -444 -perm /222 ! -perm /111 Match files that are readable for everybody, have at least one write bit set (i.e., somebody can write to them), but that cannot be executed/searched by anybody. Note that in some shells the @samp{!} must be -escaped;. +escaped. @item -perm -a+r -perm /a+w ! -perm /a+x As above.