summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2013-07-09 14:28:45 -0400
committerGravatar Joey Hess <joey@kitenet.net>2013-07-09 14:28:45 -0400
commit5672bc92978b68b2020bac3a311347652d9665ca (patch)
tree841267eda0de3b9f62eed94f3e53a7f46028bb3b
parentbf8a407da11a2143dced69489bbced6faf38db03 (diff)
expand
-rw-r--r--doc/walkthrough/removing_files.mdwn16
1 files changed, 14 insertions, 2 deletions
diff --git a/doc/walkthrough/removing_files.mdwn b/doc/walkthrough/removing_files.mdwn
index 0df6e82a1..9b85d9c3b 100644
--- a/doc/walkthrough/removing_files.mdwn
+++ b/doc/walkthrough/removing_files.mdwn
@@ -1,5 +1,17 @@
-You can always drop files safely. Git-annex checks that some other annex
-has the file before removing it.
+When you're using git-annex you can `git rm` a file just like you usually
+would with git. Just like with git, this removes the file from your work
+tree, but it does not remove the file's content from the git repository.
+If you check the file back out, or revert the removal, you can get it back.
+
+Git-annex adds the ability to remove the content of a file from your local
+repository to save space. This is called "dropping" the file.
+
+You can always drop files safely. Git-annex checks that some other
+repository still has the file before removing it.
# git annex drop iso/debian.iso
drop iso/Debian_5.0.iso ok
+
+Once dropped, the file will still appear in your work tree as a broken symlink.
+You can use `git annex get` to as usual to get this file back to your local
+repository.