{"thread":{"id":"34766","subject":"[PATCH] Documentation/remote-helpers: document common use-case for private ref","startedAt":"2013-08-26T09:21:39Z","lastAt":"2013-08-26T09:21:39Z","messageCount":1,"participants":["Matthieu Moy"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"225895","messageId":"1377508899-11104-1-git-send-email-Matthieu.Moy@imag.fr","threadId":"34766","inReplyTo":null,"subject":"[PATCH] Documentation/remote-helpers: document common use-case for private ref","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2013-08-26T09:21:39Z","receivedAt":"2013-08-26T09:21:39Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"The current documentation mentions the private ref namespace, but does\nnot really explain why it can be useful.\n\nSigned-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>\n---\nThis small patch was sent inline during a previous conversation, but\ndid not really catch attention ;-).\n\nResending as a proper patch.\n\n Documentation/gitremote-helpers.txt | 6 ++++++\n 1 file changed, 6 insertions(+)\n\ndiff --git a/Documentation/gitremote-helpers.txt b/Documentation/gitremote-helpers.txt\nindex 0827f69..9ae36da 100644\n--- a/Documentation/gitremote-helpers.txt\n+++ b/Documentation/gitremote-helpers.txt\n@@ -176,6 +176,12 @@ applicable refspec takes precedence.  The left-hand of refspecs\n advertised with this capability must cover all refs reported by\n the list command.  If no 'refspec' capability is advertised,\n there is an implied `refspec *:*`.\n++\n+When writing remote-helpers for decentralized version control\n+systems, it is advised to keep a local copy of the repository to\n+interact with, and to let the private namespace refs point to this\n+local repository, while the refs/remotes namespace is used to track\n+the remote repository.\n \n 'bidi-import'::\n \tThis modifies the 'import' capability.\n-- \n1.8.4.rc4.4.g57d5d3d\n"}]}