79d662405d1dc8df293eed84f79334fb5600a645
[git.git] / man1 / git-lost-found.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-LOST-FOUND" 1 "" "" ""
21 .SH NAME
22 git-lost-found \- Recover lost refs that luckily have not yet been pruned.
23 .SH "SYNOPSIS"
24
25
26 git\-lost\-found
27
28 .SH "DESCRIPTION"
29
30
31 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\&.
32
33 .SH "OUTPUT"
34
35
36 One line description from the commit and tag found along with their object name are printed on the standard output\&.
37
38 .SH "EXAMPLE"
39
40
41 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\&.
42
43 .IP
44 $ git lost\-found
45 [1ef2b196d909eed523d4f3c9bf54b78cdd6843c6] GIT 0\&.99\&.9c
46 \&.\&.\&.
47
48 Also you can use gitk to browse how they relate to each other and existing (probably old) tags\&.
49
50 .IP
51 $ gitk $(cd \&.git/lost\-found/commit && echo ??*)
52
53 After making sure that it is the object you are looking for, you can reconnect it to your regular \&.git/refs hierarchy\&.
54
55 .IP
56 $ git cat\-file \-t 1ef2b196
57 tag
58 $ git cat\-file tag 1ef2b196
59 object fa41bbce8e38c67a218415de6cfa510c7e50032a
60 type commit
61 tag v0\&.99\&.9c
62 tagger Junio C Hamano <junkio@cox\&.net> 1131059594 \-0800
63
64 GIT 0\&.99\&.9c
65
66 This contains the following changes from the "master" branch, since
67 \&.\&.\&.
68 $ git update\-ref refs/tags/not\-lost\-anymore 1ef2b196
69 $ git rev\-parse not\-lost\-anymore
70 1ef2b196d909eed523d4f3c9bf54b78cdd6843c6
71 .SH "AUTHOR"
72
73
74 Written by Junio C Hamano &#28657;&#37326; &#32020; <junkio@cox\&.net>
75
76 .SH "DOCUMENTATION"
77
78
79 Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
80
81 .SH "GIT"
82
83
84 Part of the \fBgit\fR(7) suite
85