Documentation / git-lost-found.txton commit git-update-ref: add --no-deref option for overwriting/detaching ref (68db31c)
   1git-lost-found(1)
   2=================
   3
   4NAME
   5----
   6git-lost-found - Recover lost refs that luckily have not yet been pruned
   7
   8SYNOPSIS
   9--------
  10'git-lost-found'
  11
  12DESCRIPTION
  13-----------
  14Finds dangling commits and tags from the object database, and
  15creates refs to them in the .git/lost-found/ directory.  Commits and
  16tags that dereference to commits are stored in .git/lost-found/commit,
  17and other objects are stored in .git/lost-found/other.
  18
  19
  20OUTPUT
  21------
  22Prints to standard output the object names and one-line descriptions
  23of any commits or tags found.
  24
  25EXAMPLE
  26-------
  27
  28Suppose you run 'git tag -f' and mistype the tag to overwrite.
  29The ref to your tag is overwritten, but until you run 'git
  30prune', the tag itself is still there.
  31
  32------------
  33$ git lost-found
  34[1ef2b196d909eed523d4f3c9bf54b78cdd6843c6] GIT 0.99.9c
  35...
  36------------
  37
  38Also you can use gitk to browse how any tags found relate to each
  39other.
  40
  41------------
  42$ gitk $(cd .git/lost-found/commit && echo ??*)
  43------------
  44
  45After making sure you know which the object is the tag you are looking
  46for, you can reconnect it to your regular .git/refs hierarchy.
  47
  48------------
  49$ git cat-file -t 1ef2b196
  50tag
  51$ git cat-file tag 1ef2b196
  52object fa41bbce8e38c67a218415de6cfa510c7e50032a
  53type commit
  54tag v0.99.9c
  55tagger Junio C Hamano <junkio@cox.net> 1131059594 -0800
  56
  57GIT 0.99.9c
  58
  59This contains the following changes from the "master" branch, since
  60...
  61$ git update-ref refs/tags/not-lost-anymore 1ef2b196
  62$ git rev-parse not-lost-anymore
  631ef2b196d909eed523d4f3c9bf54b78cdd6843c6
  64------------
  65
  66Author
  67------
  68Written by Junio C Hamano 濱野 純 <junkio@cox.net>
  69
  70Documentation
  71--------------
  72Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
  73
  74
  75GIT
  76---
  77Part of the gitlink:git[7] suite