1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-replace(
1)
</title>
312 git-replace(
1) Manual Page
315 <div class=
"sectionbody">
317 Create, list, delete refs to replace objects
322 <div class=
"sectionbody">
323 <div class=
"verseblock">
324 <div class=
"content"><em>git replace
</em> [-f]
<object
> <replacement
>
325 <em>git replace
</em> -d
<object
>…
326 <em>git replace
</em> -l [
<pattern
>]
</div></div>
328 <h2 id=
"_description">DESCRIPTION
</h2>
329 <div class=
"sectionbody">
330 <div class=
"para"><p>Adds a
<em>replace
</em> reference in
<tt>.git/refs/replace/
</tt></p></div>
331 <div class=
"para"><p>The name of the
<em>replace
</em> reference is the SHA1 of the object that is
332 replaced. The content of the
<em>replace
</em> reference is the SHA1 of the
333 replacement object.
</p></div>
334 <div class=
"para"><p>Unless
<tt>-f
</tt> is given, the
<em>replace
</em> reference must not yet exist in
335 <tt>.git/refs/replace/
</tt> directory.
</p></div>
336 <div class=
"para"><p>Replacement references will be used by default by all git commands
337 except those doing reachability traversal (prune, pack transfer and
339 <div class=
"para"><p>It is possible to disable use of replacement references for any
340 command using the
<tt>--no-replace-objects
</tt> option just after
<em>git
</em>.
</p></div>
341 <div class=
"para"><p>For example if commit
<em>foo
</em> has been replaced by commit
<em>bar
</em>:
</p></div>
342 <div class=
"listingblock">
343 <div class=
"content">
344 <pre><tt>$ git --no-replace-objects cat-file commit foo
</tt></pre>
346 <div class=
"para"><p>shows information about commit
<em>foo
</em>, while:
</p></div>
347 <div class=
"listingblock">
348 <div class=
"content">
349 <pre><tt>$ git cat-file commit foo
</tt></pre>
351 <div class=
"para"><p>shows information about commit
<em>bar
</em>.
</p></div>
352 <div class=
"para"><p>The
<em>GIT_NO_REPLACE_OBJECTS
</em> environment variable can be set to
353 achieve the same effect as the
<tt>--no-replace-objects
</tt> option.
</p></div>
355 <h2 id=
"_options">OPTIONS
</h2>
356 <div class=
"sectionbody">
357 <div class=
"vlist"><dl>
363 If an existing replace ref for the same object exists, it will
364 be overwritten (instead of failing).
372 Delete existing replace refs for the given objects.
380 List replace refs for objects that match the given pattern (or
381 all if no pattern is given).
382 Typing
"git replace" without arguments, also lists all replace
388 <h2 id=
"_bugs">BUGS
</h2>
389 <div class=
"sectionbody">
390 <div class=
"para"><p>Comparing blobs or trees that have been replaced with those that
391 replace them will not work properly. And using
<tt>git reset --hard
</tt> to
392 go back to a replaced commit will move the branch to the replacement
393 commit instead of the replaced commit.
</p></div>
394 <div class=
"para"><p>There may be other problems when using
<em>git rev-list
</em> related to
395 pending objects. And of course things may break if an object of one
396 type is replaced by an object of another type (for example a blob
397 replaced by a commit).
</p></div>
399 <h2 id=
"_see_also">SEE ALSO
</h2>
400 <div class=
"sectionbody">
401 <div class=
"para"><p><a href=
"git-tag.html">git-tag(
1)
</a>
402 <a href=
"git-branch.html">git-branch(
1)
</a>
403 <a href=
"git.html">git(
1)
</a></p></div>
405 <h2 id=
"_author">Author
</h2>
406 <div class=
"sectionbody">
407 <div class=
"para"><p>Written by Christian Couder
<chriscool@tuxfamily.org
> and Junio C
408 Hamano
<gitster@pobox.com
>, based on
<em>git tag
</em> by Kristian Hogsberg
409 <krh@redhat.com
> and Carlos Rica
<jasampler@gmail.com
>.
</p></div>
411 <h2 id=
"_documentation">Documentation
</h2>
412 <div class=
"sectionbody">
413 <div class=
"para"><p>Documentation by Christian Couder
<chriscool@tuxfamily.org
> and the
414 git-list
<git@vger.kernel.org
>, based on
<em>git tag
</em> documentation.
</p></div>
416 <h2 id=
"_git">GIT
</h2>
417 <div class=
"sectionbody">
418 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
421 <div id=
"footer-text">
422 Last updated
2010-
09-
18 23:
56:
54 UTC