{"thread":{"id":"31887","subject":"[PATCH] Doc repository-layout: Show refs/replace","startedAt":"2012-10-21T20:52:37Z","lastAt":"2012-10-25T10:34:14Z","messageCount":2,"participants":["Philip Oakley","Jeff King"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"201654","messageId":"1350852757-3924-1-git-send-email-philipoakley@iee.org","threadId":"31887","inReplyTo":null,"subject":"[PATCH] Doc repository-layout: Show refs/replace","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-10-21T20:52:37Z","receivedAt":"2012-10-21T20:52:37Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Signed-off-by: Philip Oakley <philipoakley@iee.org>\n---\n\nMy question on stackoverflow http://stackoverflow.com/questions/6800692\nhow-do-git-grafts-and-replace-differ-are-grafts-now-deprecated\nnoted that the gitrepository-layout(5) wasn't up to date. \n\nRecent hits have propmted me to offer a patch.\n\nHere is that patch.\n\nPhilip\n\n---\n\n Documentation/gitrepository-layout.txt | 6 ++++++\n 1 file changed, 6 insertions(+)\n\ndiff --git a/Documentation/gitrepository-layout.txt b/Documentation/gitrepository-layout.txt\nindex 5c891f1..d546e20 100644\n--- a/Documentation/gitrepository-layout.txt\n+++ b/Documentation/gitrepository-layout.txt\n@@ -93,6 +93,12 @@ refs/remotes/`name`::\n \trecords tip-of-the-tree commit objects of branches copied\n \tfrom a remote repository.\n \n+refs/replace/`<obj-sha1>`::\n+\trecords the SHA1 of the object that replaces `<obj-sha1>`.\n+\tThis is similar to info/grafts and is internally used and\n+\tmaintained by `git replace`. Such refs can be exchanged between\n+\trepositories while grafts are not.\n+\n packed-refs::\n \trecords the same information as refs/heads/, refs/tags/,\n \tand friends record in a more efficient way.  See\n-- \n1.7.11.msysgit.1\n"},{"id":"201887","messageId":"20121025103413.GQ8390@sigill.intra.peff.net","threadId":"31887","inReplyTo":"1350852757-3924-1-git-send-email-philipoakley@iee.org","subject":"Re: [PATCH] Doc repository-layout: Show refs/replace","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-10-25T10:34:14Z","receivedAt":"2012-10-25T10:34:14Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Sun, Oct 21, 2012 at 09:52:37PM +0100, Philip Oakley wrote:\n\n> Signed-off-by: Philip Oakley <philipoakley@iee.org>\n\nThanks, this makes sense.\n\n> +refs/replace/`<obj-sha1>`::\n> +\trecords the SHA1 of the object that replaces `<obj-sha1>`.\n> +\tThis is similar to info/grafts and is internally used and\n> +\tmaintained by `git replace`. Such refs can be exchanged between\n> +\trepositories while grafts are not.\n\nThis should probably be an actual link to the git-replace manpage. I'll\nconvert it to a linkgit. No need to resend.\n\n-Peff\n"}]}