diff options
author | Junio C Hamano <junkio@cox.net> | 2005-11-07 15:15:34 -0800 |
---|---|---|
committer | Junio C Hamano <junkio@cox.net> | 2005-11-11 21:52:20 -0800 |
commit | 04e7ca1a1bd05e733236734bd7078b4cde1f7ce5 (patch) | |
tree | 1683c5aa53165078dba39e82260c8fd0097f6931 /Documentation | |
parent | d7b1a1ddbece22c99d52ea45bdecefdb9f17a613 (diff) | |
download | git-04e7ca1a1bd05e733236734bd7078b4cde1f7ce5.tar.gz |
git-lost+found
This command helps you resurrect accidentally lost tags and commits.
Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/git-lost+found.txt | 78 | ||||
-rw-r--r-- | Documentation/git.txt | 3 |
2 files changed, 81 insertions, 0 deletions
diff --git a/Documentation/git-lost+found.txt b/Documentation/git-lost+found.txt new file mode 100644 index 0000000000..0cb8e3bbfe --- /dev/null +++ b/Documentation/git-lost+found.txt @@ -0,0 +1,78 @@ +git-lost+found(1) +================= + +NAME +---- +git-lost+found - Recover lost refs that luckily have not yet been pruned. + +SYNOPSIS +-------- +'git-lost+found' + +DESCRIPTION +----------- +Finds dangling commits and tags from the object database, and +creates refs to them in .git/lost+found/ directory. Commits and +tags that dereference to commits go to .git/lost+found/commit +and others are stored in .git/lost+found/other directory. + + +OUTPUT +------ +One line description from the commit and tag found along with +their object name are printed on the standard output. + + +EXAMPLE +------- + +Suppose you run 'git tag -f' and mistyped the tag to overwrite. +The ref to your tag is overwritten, but until you run 'git +prune', it is still there. + +------------ +$ git lost+found +[1ef2b196d909eed523d4f3c9bf54b78cdd6843c6] GIT 0.99.9c +... +------------ + +Also you can use gitk to browse how they relate to each other +and existing (probably old) tags. + +------------ +$ gitk $(cd .git/lost+found/commit && echo ??*) +------------ + +After making sure that it is the object you are looking for, you +can reconnect it to your regular .git/refs hierarchy. + +------------ +$ git cat-file -t 1ef2b196 +tag +$ git cat-file tag 1ef2b196 +object fa41bbce8e38c67a218415de6cfa510c7e50032a +type commit +tag v0.99.9c +tagger Junio C Hamano <junkio@cox.net> 1131059594 -0800 + +GIT 0.99.9c + +This contains the following changes from the "master" branch, since +... +$ git update-ref refs/tags/not-lost-anymore 1ef2b196 +$ git rev-parse not-lost-anymore +1ef2b196d909eed523d4f3c9bf54b78cdd6843c6 +------------ + +Author +------ +Written by Junio C Hamano <junkio@cox.net> + +Documentation +-------------- +Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. + + +GIT +--- +Part of the gitlink:git[7] suite diff --git a/Documentation/git.txt b/Documentation/git.txt index b7bc4fb231..a9d47c115c 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -309,6 +309,9 @@ gitlink:git-convert-objects[1]:: gitlink:git-cvsimport[1]:: Salvage your data out of another SCM people love to hate. +gitlink:git-lost+found[1]:: + Recover lost refs that luckily have not yet been pruned. + gitlink:git-merge-one-file[1]:: The standard helper program to use with "git-merge-index" |