From c6bbfc6c2ef86b88222890dceb5f4ab393deefe1 Mon Sep 17 00:00:00 2001
From: Iustin Pop <iustin@k1024.org>
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.5