man/apply-default-acl.1: add a note about the --recursive exit codes.

diff --git a/doc/man/apply-default-acl.1 b/doc/man/apply-default-acl.1
index 6d77ce1ef4f25b006d7a8382e2ea9ec22ff9ff3a..b13d5fd910990ff22520668d8e48df74bd1ef3ab 100644 (file)
--- a/doc/man/apply-default-acl.1
+++ b/doc/man/apply-default-acl.1
@@ -51,3 +51,10 @@ collected and the \(dqworst\(dq result is returned. For example, if
 one path succeeds and another fails, the overall result will be
 failure. If one succeeds, one fails, and one causes an error, then the
 overall result will be an error; and so on.
+.P
+The \fB\-\-recursive\fR flag modifies this behavior. Due to an
+implementation detail, the recursive operation will return
+EXIT_SUCCESS even if it encounters links or inaccessible paths during
+the traversal. Beware; this means that manually supplying all children
+of a directory on the command-line does not act the same as operating
+on that directory recursively.