summaryrefslogtreecommitdiff
path: root/doc/walkthrough
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2014-02-02 17:01:41 -0400
committerGravatar Joey Hess <joey@kitenet.net>2014-02-02 17:01:41 -0400
commitd88ccb9eec86a5744a2d726ea4b82ba16ed5bd83 (patch)
tree96e0e2352c89b38e0281c4c1344442849ff58ba0 /doc/walkthrough
parentc7dacb9ebb1b045e4d2cc60590c6dd91bc9db929 (diff)
add a walkthrough section discussing git-annex's skipping of files on noop
Diffstat (limited to 'doc/walkthrough')
-rw-r--r--doc/walkthrough/quiet_please:_When_git-annex_seems_to_skip_files.mdwn27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/walkthrough/quiet_please:_When_git-annex_seems_to_skip_files.mdwn b/doc/walkthrough/quiet_please:_When_git-annex_seems_to_skip_files.mdwn
new file mode 100644
index 000000000..188ca634b
--- /dev/null
+++ b/doc/walkthrough/quiet_please:_When_git-annex_seems_to_skip_files.mdwn
@@ -0,0 +1,27 @@
+One behavior of git-annex is sometimes confusing at first, but it turns out
+to be useful once you get to know it.
+
+ # git annex drop *
+ #
+
+Why didn't git-annex seem to do anything despite being asked to drop all the
+files? Because it checked them all, and none of them are present.
+
+Most git-annex commands will behave this way when they're able to quickly
+check that nothing needs to be done about a file.
+
+Running a git-annex command without specifying any file name will
+make git-annex look for files in the current directory and its
+subdirectories. So, we can add all new files to the annex easily:
+
+ # echo hi > subdir/subsubdir/newfile
+ # git annex add
+ add subdir/subsubdir/newfile ok
+
+When doing this kind of thing, having nothing shown for files
+that it doesn't need to act on is useful because it prevents swamping
+you with output. You only see the files it finds it does need to act on.
+
+So remember: If git-annex seems to not do anything when you tell it to, it's
+not being lazy -- It's checked that nothing needs to be done to get to the
+state you asked for!