aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2014-02-20 14:45:17 -0400
committerGravatar Joey Hess <joey@kitenet.net>2014-02-20 14:45:17 -0400
commit518f5b76d0aeb59f817178c1a09ec8bde7a715a3 (patch)
tree9bcead76a92b89da08bb35ac0152faaea352fe7b /doc
parent313e2e4b3ba805d59a71cf8b7617db3602daafb4 (diff)
fsck: When run with --all or --unused, while .gitattributes annex.numcopies cannot be honored since it's operating on keys instead of files, make it honor the global numcopies setting, and the annex.numcopies git config setting.
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: