summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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.