From c6bbfc6c2ef86b88222890dceb5f4ab393deefe1 Mon Sep 17 00:00:00 2001 From: Iustin Pop Date: Thu, 14 Nov 2019 11:45:26 +0100 Subject: [PATCH] Note that ACL(text="...") needs a valid ACL to be passed Closes #9. --- acl.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/acl.c b/acl.c index 9f2d603..f13a5c1 100644 --- a/acl.c +++ b/acl.c @@ -1266,11 +1266,13 @@ static char __ACL_Type_doc__[] = ":param int fd: creates an ACL representing\n" " the access ACL of the given file descriptor.\n" ":param string text: creates an ACL from a \n" - " textual description.\n" + " textual description; note the ACL must be valid, which\n" + " means including a mask for extended ACLs, similar to\n" + " ``setfacl --no-mask``\n" ":param ACL acl: creates a copy of an existing ACL instance.\n" ":param int mode: creates an ACL from a numeric mode\n" - " (e.g. mode=0644); this is valid only when the C library\n" - " provides the acl_from_mode call, and\n" + " (e.g. ``mode=0644``); this is valid only when the C library\n" + " provides the ``acl_from_mode call``, and\n" " note that no validation is done on the given value.\n" "\n" "If no parameters are passed, an empty ACL will be created; this\n" -- 2.39.2