From 0bba2627df1470a3794b638878388bddfd9593ec Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Fri, 22 Apr 2016 14:49:15 -0400 Subject: [PATCH] response; improve docs --- ...omment_5_2123944418123c3aaf187d34df5c11e0._comment | 11 +++++++++++ doc/git-annex.mdwn | 3 ++- doc/tuning.mdwn | 3 ++- 3 files changed, 15 insertions(+), 2 deletions(-) create mode 100644 doc/bugs/OSX_case_insensitive_filesystem/comment_5_2123944418123c3aaf187d34df5c11e0._comment 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 0000000000..e8c9c3efe0 --- /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 1b80fe00b2..236912df6e 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 . # CONFIGURATION VIA .gitattributes diff --git a/doc/tuning.mdwn b/doc/tuning.mdwn index ed3c90f025..1860295465 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.