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

2 messages from 2012-10-21 to 2012-10-25. Participants: Philip Oakley, Jeff King.
Thread: https://gitlist.dev/t/31887

## Philip Oakley, 2012-10-21 20:52

Subject: [PATCH] Doc repository-layout: Show refs/replace
Message-ID: <1350852757-3924-1-git-send-email-philipoakley@iee.org>
URL: https://gitlist.dev/e/1350852757-3924-1-git-send-email-philipoakley%40iee.org

```
Signed-off-by: Philip Oakley <philipoakley@iee.org>
---

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

```

## Jeff King, 2012-10-25 10:34

Subject: Re: [PATCH] Doc repository-layout: Show refs/replace
Message-ID: <20121025103413.GQ8390@sigill.intra.peff.net>
URL: https://gitlist.dev/e/20121025103413.GQ8390%40sigill.intra.peff.net
In-Reply-To: <1350852757-3924-1-git-send-email-philipoakley@iee.org>

```
On Sun, Oct 21, 2012 at 09:52:37PM +0100, Philip Oakley wrote:

> Signed-off-by: Philip Oakley <philipoakley@iee.org>

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

```