Blame SOURCES/acl-2.2.52-setfacl-man-page.patch

7fbafb
From ecee95a94420d6b0336d4caec6bc66b53442367b Mon Sep 17 00:00:00 2001
7fbafb
From: Kamil Dudka <kdudka@redhat.com>
7fbafb
Date: Thu, 19 May 2016 10:28:13 +0200
7fbafb
Subject: [PATCH] setfacl.1: document the meaning of '-' in perms
7fbafb
7fbafb
[agruen: Description further clarified.]
7fbafb
7fbafb
Upstream-commit: ea3c6bb711e76d91759f8bf5475e1900362a3142
7fbafb
Signed-off-by: Kamil Dudka <kdudka@redhat.com>
7fbafb
---
7fbafb
 man/man1/setfacl.1 | 28 +++++++++++++++++++++-------
7fbafb
 1 file changed, 21 insertions(+), 7 deletions(-)
7fbafb
7fbafb
diff --git a/man/man1/setfacl.1 b/man/man1/setfacl.1
7fbafb
index 0c7c046..e092e51 100644
7fbafb
--- a/man/man1/setfacl.1
7fbafb
+++ b/man/man1/setfacl.1
7fbafb
@@ -194,18 +194,32 @@ you can specify either a name or a number.
7fbafb
 .PP
7fbafb
 The
7fbafb
 .I perms
7fbafb
-field is a combination of characters that indicate the permissions: read
7fbafb
+field is a combination of characters that indicate the read
7fbafb
 .IR (r) ,
7fbafb
 write
7fbafb
 .IR (w) ,
7fbafb
 execute
7fbafb
-.IR (x) ,
7fbafb
-execute only if the file is a directory or already has execute permission
7fbafb
-for some user
7fbafb
-.IR (X) .
7fbafb
-Alternatively, the
7fbafb
+.IR (x)
7fbafb
+permissions.  Dash characters in the
7fbafb
 .I perms
7fbafb
-field can be an octal digit (0\-7).
7fbafb
+field
7fbafb
+.IR (\-)
7fbafb
+are ignored.  The character
7fbafb
+.I X
7fbafb
+stands for the execute permission if the file is a directory or already has
7fbafb
+execute permission for some user.  Alternatively, the
7fbafb
+.I perms
7fbafb
+field can define the permissions numerically, as a bit-wise combination of read
7fbafb
+.IR (4) ,
7fbafb
+write
7fbafb
+.IR (2) ,
7fbafb
+and execute
7fbafb
+.IR (1) .
7fbafb
+Zero
7fbafb
+.I perms
7fbafb
+fields or
7fbafb
+.I perms
7fbafb
+fields that only consist of dashes indicate no permissions.
7fbafb
 .PP
7fbafb
 .SS AUTOMATICALLY CREATED ENTRIES
7fbafb
 Initially, files and directories contain only the three base ACL entries
7fbafb
-- 
7fbafb
2.5.5
7fbafb