path: root/Documentation/git-lost-found.txt
diff options
authorJunio C Hamano <>2005-11-13 10:07:02 (GMT)
committerJunio C Hamano <>2005-11-13 10:07:02 (GMT)
commit0086e2c854e3af3209915e4ec2f933bcef400050 (patch)
tree57701ab66d75e8f02c9db9b2e6e1bdfc11fccf11 /Documentation/git-lost-found.txt
parentabacbe4166bcf9d62f430a4a75de2e82df3799b1 (diff)
Rename lost+found to lost-found.
Because we use "lost-found" as the directory name to hold dangling object names, it is confusing to call the command git-lost+found, although it makes sense and is even cute ;-). Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-lost-found.txt')
1 files changed, 78 insertions, 0 deletions
diff --git a/Documentation/git-lost-found.txt b/Documentation/git-lost-found.txt
new file mode 100644
index 0000000..03156f2
--- /dev/null
+++ b/Documentation/git-lost-found.txt
@@ -0,0 +1,78 @@
+git-lost-found - Recover lost refs that luckily have not yet been pruned.
+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.
+One line description from the commit and tag found along with
+their object name are printed on the standard output.
+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
+$ git cat-file tag 1ef2b196
+object fa41bbce8e38c67a218415de6cfa510c7e50032a
+type commit
+tag v0.99.9c
+tagger Junio C Hamano <> 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
+Written by Junio C Hamano 濱野 純 <>
+Documentation by Junio C Hamano and the git-list <>.
+Part of the gitlink:git[7] suite