Documentation/replace: add Creating Replacement Objects section
There were no hints in the documentation about how to create replacement objects. Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Christian Couder committed
Sep 6, 2013 at 07:10 UTC
b8fcce1e7f7baafba8b6ba0b4e9bec2f27893f43
1 file changed
+16
Documentation/git-replace.txt
+16
@@ -66,6 +66,19 @@ OPTIONS
66
Typing "git replace" without arguments, also lists all replace
67
refs.
68
69
+CREATING REPLACEMENT OBJECTS
70
+----------------------------
71
+
72
+linkgit:git-filter-branch[1], linkgit:git-hash-object[1] and
73
+linkgit:git-rebase[1], among other git commands, can be used to create
74
+replacement objects from existing objects.
75
+
76
+If you want to replace many blobs, trees or commits that are part of a
77
+string of commits, you may just want to create a replacement string of
78
+commits and then only replace the commit at the tip of the target
79
+string of commits with the commit at the tip of the replacement string
80
+of commits.
81
+
82
BUGS
83
----
84
Comparing blobs or trees that have been replaced with those that
@@ -78,6 +91,9 @@ pending objects.
91
92
SEE ALSO
93
--------
94
+linkgit:git-hash-object[1]
95
+linkgit:git-filter-branch[1]
96
+linkgit:git-rebase[1]
97
linkgit:git-tag[1]
98
linkgit:git-branch[1]
99
linkgit:git[1]