man: improve statoverride description

A statoverride file written in the obvious way will produce incorrect
results for two independent reasons.  Document them.

diff --git a/man/ostree-commit.xml b/man/ostree-commit.xml
index 81af7bf22627f6e13d5628e60647bdd559b50126..e1e3a8b9b0d377ef058da753976927377ba0a192 100644 (file)
--- a/man/ostree-commit.xml
+++ b/man/ostree-commit.xml
@@ -232,7 +232,9 @@ Boston, MA 02111-1307, USA.
                 <term><option>--statoverride</option>="PATH"</term>
 
                 <listitem><para>
-                    File containing list of modifications to make permissions (file mode, followed by space, followed by file path).
+                    File containing list of modifications to make permissions (file mode in
+                    decimal, followed by space, followed by file path).  The specified mode
+                    is ORed with the file's original mode unless preceded by "=".
                 </para></listitem>
             </varlistentry>