[PATCH] Doc repository-layout: Show refs/replace

Subsystems: documentation, the rest

STALE3717d

2 messages, 2 authors, 2016-06-15 · open the first message on its own page

[PATCH] Doc repository-layout: Show refs/replace

From: Philip Oakley <hidden>
Date: 2016-06-15 22:55:05

Signed-off-by: Philip Oakley <redacted>
---

My question on stackoverflow http://stackoverflow.com/questions/6800692
how-do-git-grafts-and-replace-differ-are-grafts-now-deprecated
noted that the gitrepository-layout(5) wasn't up to date. 

Recent hits have propmted me to offer a patch.

Here is that patch.

Philip

---

 Documentation/gitrepository-layout.txt | 6 ++++++
 1 file changed, 6 insertions(+)
diff --git a/Documentation/gitrepository-layout.txt b/Documentation/gitrepository-layout.txt
index 5c891f1..d546e20 100644
--- a/Documentation/gitrepository-layout.txt
+++ b/Documentation/gitrepository-layout.txt
@@ -93,6 +93,12 @@ refs/remotes/`name`::
 	records tip-of-the-tree commit objects of branches copied
 	from a remote repository.
 
+refs/replace/`<obj-sha1>`::
+	records the SHA1 of the object that replaces `<obj-sha1>`.
+	This is similar to info/grafts and is internally used and
+	maintained by `git replace`. Such refs can be exchanged between
+	repositories while grafts are not.
+
 packed-refs::
 	records the same information as refs/heads/, refs/tags/,
 	and friends record in a more efficient way.  See
-- 
1.7.11.msysgit.1

Re: [PATCH] Doc repository-layout: Show refs/replace

From: Jeff King <hidden>
Date: 2016-06-15 22:55:06

On Sun, Oct 21, 2012 at 09:52:37PM +0100, Philip Oakley wrote:
Signed-off-by: Philip Oakley <redacted>
Thanks, this makes sense.
+refs/replace/`<obj-sha1>`::
+	records the SHA1 of the object that replaces `<obj-sha1>`.
+	This is similar to info/grafts and is internally used and
+	maintained by `git replace`. Such refs can be exchanged between
+	repositories while grafts are not.
This should probably be an actual link to the git-replace manpage. I'll
convert it to a linkgit. No need to resend.

-Peff
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help