aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-replace.txt
diff options
context:
space:
mode:
authorJohannes Schindelin <johannes.schindelin@gmx.de>2018-04-29 00:44:35 +0200
committerJunio C Hamano <gitster@pobox.com>2018-04-30 11:12:30 +0900
commitfb40429109723c0d8ec77ba81421f508ac2532a0 (patch)
tree17b51ed573a61474b80f0a8da0d953ef042835fb /Documentation/git-replace.txt
parent041c98e22d88d963a92f1bac6ab348a0d4c6d228 (diff)
downloadgit-fb40429109723c0d8ec77ba81421f508ac2532a0.tar.gz
replace: introduce --convert-graft-file
This option is intended to help with the transition away from the now-deprecated graft file. Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-replace.txt')
-rw-r--r--Documentation/git-replace.txt11
1 files changed, 8 insertions, 3 deletions
diff --git a/Documentation/git-replace.txt b/Documentation/git-replace.txt
index e5c57ae6ef..246dc9943c 100644
--- a/Documentation/git-replace.txt
+++ b/Documentation/git-replace.txt
@@ -11,6 +11,7 @@ SYNOPSIS
'git replace' [-f] <object> <replacement>
'git replace' [-f] --edit <object>
'git replace' [-f] --graft <commit> [<parent>...]
+'git replace' [-f] --convert-graft-file
'git replace' -d <object>...
'git replace' [--format=<format>] [-l [<pattern>]]
@@ -87,9 +88,13 @@ OPTIONS
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.
+ commit. Use `--convert-graft-file` to convert a
+ `$GIT_DIR/info/grafts` file and use replace refs instead.
+
+--convert-graft-file::
+ Creates graft commits for all entries in `$GIT_DIR/info/grafts`
+ and deletes that file upon success. The purpose is to help users
+ with transitioning off of the now-deprecated graft file.
-l <pattern>::
--list <pattern>::