summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2013-07-08 16:17:28 -0400
committerGravatar Joey Hess <joey@kitenet.net>2013-07-08 16:17:28 -0400
commitcc47dca592206f70f33bb07e3a80287f0b5e8f0c (patch)
treed7f9634121400190100a5f53e4215c45a1192b17
parent7bff599aff5a4d8cc7026cd71d52410e151138da (diff)
add a new item to walkthrough, as people get confused about whether tags and branches are supported (they are)
-rw-r--r--doc/walkthrough.mdwn1
-rw-r--r--doc/walkthrough/using_tags_and_branches.mdwn14
2 files changed, 15 insertions, 0 deletions
diff --git a/doc/walkthrough.mdwn b/doc/walkthrough.mdwn
index c288b71de..e4e3c2222 100644
--- a/doc/walkthrough.mdwn
+++ b/doc/walkthrough.mdwn
@@ -15,6 +15,7 @@ A walkthrough of the basic features of git-annex.
walkthrough/modifying_annexed_files
walkthrough/using_ssh_remotes
walkthrough/moving_file_content_between_repositories
+ walkthough/using_tags_and_branches
walkthrough/unused_data
walkthrough/fsck:_verifying_your_data
walkthrough/fsck:_when_things_go_wrong
diff --git a/doc/walkthrough/using_tags_and_branches.mdwn b/doc/walkthrough/using_tags_and_branches.mdwn
new file mode 100644
index 000000000..06f021472
--- /dev/null
+++ b/doc/walkthrough/using_tags_and_branches.mdwn
@@ -0,0 +1,14 @@
+Like git, git-annex hangs on to every old version of a file, so you can
+make tags and branches, and can check them out later to look at the old
+files.
+
+ # git tag 1.0
+ # rm -f my_cool_big_file
+ # git commit -m deleted
+ # git checkout 1.0
+ # cat my_cool_big_file
+ yay! old version still here
+
+Of course, when you `git checkout` an old branch, some old versions of
+files may not be locally available, and may be stored in some other
+repository. You can use `git annex get` to get them as usual.