{"thread":{"id":"18858","subject":"[PATCH] Documentation: add documentation for \"git replace\"","startedAt":"2009-04-13T22:36:59Z","lastAt":"2009-04-13T22:36:59Z","messageCount":1,"participants":["Christian Couder"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"111246","messageId":"20090414003659.41d02ae6.chriscool@tuxfamily.org","threadId":"18858","inReplyTo":null,"subject":"[PATCH] Documentation: add documentation for \"git replace\"","fromName":"Christian Couder","fromEmail":"chriscool@tuxfamily.org","sentAt":"2009-04-13T22:36:59Z","receivedAt":"2009-04-13T22:36:59Z","isPatch":true,"sender":{"key":"christian.couder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/208954?v=4"},"body":"Signed-off-by: Christian Couder <chriscool@tuxfamily.org>\n---\n Documentation/git-replace.txt |   71 +++++++++++++++++++++++++++++++++++++++++\n 1 files changed, 71 insertions(+), 0 deletions(-)\n create mode 100644 Documentation/git-replace.txt\n\ndiff --git a/Documentation/git-replace.txt b/Documentation/git-replace.txt\nnew file mode 100644\nindex 0000000..915cb77\n--- /dev/null\n+++ b/Documentation/git-replace.txt\n@@ -0,0 +1,71 @@\n+git-replace(1)\n+==============\n+\n+NAME\n+----\n+git-replace - Create, list, delete refs to replace objects\n+\n+SYNOPSIS\n+--------\n+[verse]\n+'git replace' [-f] <object> <replacement>\n+'git replace' -d <object>...\n+'git replace' -l [<pattern>]\n+\n+DESCRIPTION\n+-----------\n+Adds a 'replace' reference in `.git/refs/replace/`\n+\n+The name of the 'replace' reference is the SHA1 of the object that is\n+replaced. The content of the replace reference is the SHA1 of the\n+replacement object.\n+\n+Unless `-f` is given, the replace reference must not yet exist in\n+`.git/refs/replace/` directory.\n+\n+OPTIONS\n+-------\n+-f::\n+\tIf an existing replace ref for the same object exists, it will\n+\tbe overwritten (instead of failing).\n+\n+-d::\n+\tDelete existing replace refs for the given objects.\n+\n+-l <pattern>::\n+\tList replace refs for objects that match the given pattern (or\n+\tall if no pattern is given).\n+\tTyping \"git replace\" without arguments, also lists all replace\n+\trefs.\n+\n+BUGS\n+----\n+Comparing blobs or trees that have been replaced with those that\n+replace them will not work properly. And using 'git reset --hard' to\n+go back to a replaced commit will move the branch to the replacement\n+commit instead of the replaced commit.\n+\n+There may be other problems when using 'git rev-list' related to\n+pending objects. And of course things may break if an object of one\n+type is replaced by an object of another type (for example a blob\n+replaced by a commit).\n+\n+SEE ALSO\n+--------\n+linkgit:git-tag[1]\n+linkgit:git-branch[1]\n+\n+Author\n+------\n+Written by Christian Couder <chriscool@tuxfamily.org> and Junio C\n+Hamano <gitster@pobox.com>, based on 'git tag' by Kristian Hogsberg\n+<krh@redhat.com> and Carlos Rica <jasampler@gmail.com>.\n+\n+Documentation\n+--------------\n+Documentation by Christian Couder <chriscool@tuxfamily.org> and the\n+git-list <git@vger.kernel.org>, based on 'git tag' documentation.\n+\n+GIT\n+---\n+Part of the linkgit:git[1] suite\n-- \n1.6.2.2.572.g4420a\n"}]}