From: Christian Couder Date: Fri, 6 Sep 2013 05:10:57 +0000 (+0200) Subject: Documentation/replace: add Creating Replacement Objects section X-Git-Tag: v1.8.5-rc0~76^2~3 X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/b8fcce1e7f7baafba8b6ba0b4e9bec2f27893f43?ds=inline;hp=--cc 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 Signed-off-by: Junio C Hamano --- b8fcce1e7f7baafba8b6ba0b4e9bec2f27893f43 diff --git a/Documentation/git-replace.txt b/Documentation/git-replace.txt index d198006c56..a2bd2ee361 100644 --- a/Documentation/git-replace.txt +++ b/Documentation/git-replace.txt @@ -66,6 +66,19 @@ OPTIONS Typing "git replace" without arguments, also lists all replace refs. +CREATING REPLACEMENT OBJECTS +---------------------------- + +linkgit:git-filter-branch[1], linkgit:git-hash-object[1] and +linkgit:git-rebase[1], among other git commands, can be used to create +replacement objects from existing objects. + +If you want to replace many blobs, trees or commits that are part of a +string of commits, you may just want to create a replacement string of +commits and then only replace the commit at the tip of the target +string of commits with the commit at the tip of the replacement string +of commits. + BUGS ---- Comparing blobs or trees that have been replaced with those that @@ -78,6 +91,9 @@ pending objects. SEE ALSO -------- +linkgit:git-hash-object[1] +linkgit:git-filter-branch[1] +linkgit:git-rebase[1] linkgit:git-tag[1] linkgit:git-branch[1] linkgit:git[1]