Merge branch 'nd/strbuf-utf8-replace'
[gitweb.git] / Documentation / git-replace.txt
index 089dcac0478407a89aea702988adcb4135510180..8fff598fd6e86c3e4a3e30e3c41f1c63ffb6a212 100644 (file)
@@ -10,6 +10,7 @@ SYNOPSIS
 [verse]
 'git replace' [-f] <object> <replacement>
 'git replace' [-f] --edit <object>
+'git replace' [-f] --graft <commit> [<parent>...]
 'git replace' -d <object>...
 'git replace' [--format=<format>] [-l [<pattern>]]
 
@@ -81,6 +82,15 @@ OPTIONS
        cannot be pretty-printed. Note that you may need to configure
        your editor to cleanly read and write binary data.
 
+--graft <commit> [<parent>...]::
+       Create a graft commit. A new commit is created with the same
+       content as <commit> except that its parents will be
+       [<parent>...] instead of <commit>'s parents. A replacement ref
+       is then created to replace <commit> with the newly created
+       commit. See contrib/convert-grafts-to-replace-refs.sh for an
+       example script based on this option that can convert grafts to
+       replace refs.
+
 -l <pattern>::
 --list <pattern>::
        List replace refs for objects that match the given pattern (or