From d7284a92f02a9058042823417055cef602ea5ec9 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Sat, 19 Nov 2016 21:38:13 +0100
Subject: [PATCH] docs: clarify --umask usage, fixes #1859

---
 docs/usage.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/usage.rst b/docs/usage.rst
index 2a3538b22..09d1e2b4b 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -746,6 +746,17 @@ a new repository when changing chunker params.
 
 For more details, see :ref:`chunker_details`.
 
+
+--umask
+~~~~~~~
+
+If you use ``--umask``, make sure that all repository-modifying borg commands
+(create, delete, prune) that access the repository in question use the same
+``--umask`` value.
+
+If multiple machines access the same repository, this should hold true for all
+of them.
+
 --read-special
 ~~~~~~~~~~~~~~