response; improve docs

3 files changed, 15 insertions, 2 deletions

diff --git a/doc/bugs/OSX_case_insensitive_filesystem/comment_5_2123944418123c3aaf187d34df5c11e0._comment b/doc/bugs/OSX_case_insensitive_filesystem/comment_5_2123944418123c3aaf187d34df5c11e0._comment
new file mode 100644
index 000000000..e8c9c3efe
--- /dev/null
+++ b/doc/bugs/OSX_case_insensitive_filesystem/comment_5_2123944418123c3aaf187d34df5c11e0._comment
@@ -0,0 +1,11 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 5"""
+ date="2016-04-22T18:41:22Z"
+ content="""
+You should not set annex.tune.* globally. Only set it when
+initializing a new git-annex repo for the first time. Clones of the repo will
+automatically inherit the tunings.
+
+See [[tuning]].
+"""]]
diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn
index 1b80fe00b..236912df6 100644
--- a/doc/git-annex.mdwn
+++ b/doc/git-annex.mdwn
@@ -1311,7 +1311,8 @@ Here are all the supported configuration settings.
 * `annex.tune.objecthash1`, `annex.tune.objecthashlower`, `annex.tune.branchhash1`
 
   These can be passed to `git annex init` to tune the repository.
-  They cannot be safely changed in a running repository.
+  They cannot be safely changed in a running repository and should never be
+  set in global git configuration.
   For details, see <https://git-annex.branchable.com/tuning/>.
 
 # CONFIGURATION VIA .gitattributes
diff --git a/doc/tuning.mdwn b/doc/tuning.mdwn
index ed3c90f02..186029546 100644
--- a/doc/tuning.mdwn
+++ b/doc/tuning.mdwn
@@ -43,4 +43,5 @@ The following tuning parameters are available:
 
 Note that git-annex will automatically propagate these settings to
 `.git/config` for tuned repositories. You should never directly change
-these settings in `.git/config`
+these settings in `.git/config`, and should never set them in global
+gitconfig.