From ecee95a94420d6b0336d4caec6bc66b53442367b Mon Sep 17 00:00:00 2001

From: Kamil Dudka <kdudka@redhat.com>

Date: Thu, 19 May 2016 10:28:13 +0200

Subject: [PATCH] setfacl.1: document the meaning of '-' in perms

[agruen: Description further clarified.]

Upstream-commit: ea3c6bb711e76d91759f8bf5475e1900362a3142

Signed-off-by: Kamil Dudka <kdudka@redhat.com>

---

 man/man1/setfacl.1 | 28 +++++++++++++++++++++-------

 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/man/man1/setfacl.1 b/man/man1/setfacl.1

index 0c7c046..e092e51 100644

--- a/man/man1/setfacl.1

+++ b/man/man1/setfacl.1

@@ -194,18 +194,32 @@ you can specify either a name or a number.

 .PP

 The

 .I perms

-field is a combination of characters that indicate the permissions: read

+field is a combination of characters that indicate the read

 .IR (r) ,

 write

 .IR (w) ,

 execute

-.IR (x) ,

-execute only if the file is a directory or already has execute permission

-for some user

-.IR (X) .

-Alternatively, the

+.IR (x)

+permissions.  Dash characters in the

 .I perms

-field can be an octal digit (0\-7).

+field

+.IR (\-)

+are ignored.  The character

+.I X

+stands for the execute permission if the file is a directory or already has

+execute permission for some user.  Alternatively, the

+.I perms

+field can define the permissions numerically, as a bit-wise combination of read

+.IR (4) ,

+write

+.IR (2) ,

+and execute

+.IR (1) .

+Zero

+.I perms

+fields or

+.I perms

+fields that only consist of dashes indicate no permissions.

 .PP

 .SS AUTOMATICALLY CREATED ENTRIES

 Initially, files and directories contain only the three base ACL entries

-- 

2.5.5