From: Michael Orlitzky <michael@orlitzky.com>
Date: Wed, 23 Jan 2013 17:25:16 +0000 (-0500)
Subject: Add a manpage and update Makefile.am to install it.
X-Git-Tag: v0.0.4~5
X-Git-Url: https://gitweb.michael.orlitzky.com/?p=apply-default-acl.git;a=commitdiff_plain;h=941842c6bdda382c5b16124a55d2ab1cf2270d07

Add a manpage and update Makefile.am to install it.
---

diff --git a/Makefile.am b/Makefile.am
index cf530a0..6f455d7 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,2 +1,3 @@
 SUBDIRS = src
 EXTRA_DIST = doc run-tests.sh
+man_MANS = doc/man/apply-default-acl.1
diff --git a/doc/man/apply-default-acl.1 b/doc/man/apply-default-acl.1
new file mode 100644
index 0000000..75c7a75
--- /dev/null
+++ b/doc/man/apply-default-acl.1
@@ -0,0 +1,39 @@
+.TH apply-default-acl 1
+
+.SH NAME
+apply-default-acl \- Apply default POSIX ACLs to files and directories.
+
+.SH SYNOPSIS
+
+\fBapply-default-acl\fR [\fB-rx\fR] \fIpath\fR [\fIpath2 ...\fR]
+
+.SH DESCRIPTION
+
+.P
+If the directory containing \fIpath\fR has a default ACL, the ACL on
+\fIpath\fR is replaced with that default. Symbolic links are not
+followed.
+
+.P
+By default, a heuristic is used to determine whether or not the
+execute bit is masked on \fIpath\fR. If \fIpath\fR is not a directory,
+and no user or group has \fBeffective\fR execute permissions on
+\fIpath\fR, then the execute bit will not masked. Otherwise, it is
+left alone. In effect we pretend that the \fBx\fR permission acts like
+the \fBX\fR (note the case difference) permission of \fBsetfacl\fR.
+
+.P
+This behavior can be modified with the \fB--no-exec-mask\fR flag.
+
+.SH OPTIONS
+
+.IP \fB\-\-recursive\fR,\ \fB\-r\fR
+Apply default ACLs recursively. This works top-down, so if directory
+\fBfoo\fR is in another directory \fBbar\fR which has a default ACL,
+then \fBbar\fR's default ACL will be applied to \fBfoo\fR before the
+contents of \fBfoo\fR are processed.
+
+.IP \fB\-\-no-exec-mask\fR,\ \fB\-x\fR
+Apply the default ACL literally; that is, don't use a heuristic to
+decide whether or not to mask the execute bit. This usually results in
+looser-than-necessary execute permissions.