summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/bugs/Numcopies_not_checked_when_running_with_--all.mdwn16
-rw-r--r--doc/git-annex.mdwn9
2 files changed, 25 insertions, 0 deletions
diff --git a/doc/bugs/Numcopies_not_checked_when_running_with_--all.mdwn b/doc/bugs/Numcopies_not_checked_when_running_with_--all.mdwn
index 87063c2dd..e4a364195 100644
--- a/doc/bugs/Numcopies_not_checked_when_running_with_--all.mdwn
+++ b/doc/bugs/Numcopies_not_checked_when_running_with_--all.mdwn
@@ -22,3 +22,19 @@ Linux (Ubuntu 13.10)
# End of transcript or log.
"""]]
+
+> It's expected that --all (and --unused) make .gitattributes
+> annex.numcopies settings be ignored, because with these options git-annex
+> is operating on keys, it does not know or care what filename they're
+> associated with, and so cannot look them up in .gitattributes. I have
+> improved the documentation of .gitattributes files to mention this
+> limitation.
+>
+> I also notice that fsck --all is not checking .git/config's
+> annex.numcopies or the new global numcopies setting. It certianly makes
+> sense for those numcopies settings to be paid attention to.
+> [[fixed|done]] --[[Joey]]
+>
+> (--all is faster because it can quickly scan through .git/annex/objects
+> to find everything, rather than looking at the symlink target of every
+> file in the work tree.)
diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn
index e7183dc87..87eeda4fd 100644
--- a/doc/git-annex.mdwn
+++ b/doc/git-annex.mdwn
@@ -1625,6 +1625,15 @@ for flac files:
Note that setting numcopies to 0 is very unsafe.
+These settings are honored by git-annex whenever it's operating on a
+matching file. However, when using --all, --unused, or --key to specify
+keys to operate on, git-annex is operating on keys and not files, so will
+not honor the settings from .gitattributes.
+
+Also note that when using views, only the toplevel .gitattributes file is
+preserved in the view, so other settings in other files won't have any
+efffect.
+
# FILES
These files are used by git-annex: