path: root/Documentation/gitremote-helpers.txt
diff options
authorJunio C Hamano <>2013-09-12 21:41:50 (GMT)
committerJunio C Hamano <>2013-09-12 21:41:50 (GMT)
commit7b828a0514a316b17c89e7f6b591fef539836c88 (patch)
tree517ea148770f32b5e1d1c8aac76ded834d77ac2b /Documentation/gitremote-helpers.txt
parent8ee9a1830017b6f4b9dfc7c7be7e6fa1618633ea (diff)
parent3f36eb43059aef4ec0f40fd8cc7081c0a1a92c31 (diff)
Merge branch 'mm/remote-helpers-doc'
* mm/remote-helpers-doc: Documentation/remote-helpers: document common use-case for private ref
Diffstat (limited to 'Documentation/gitremote-helpers.txt')
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/gitremote-helpers.txt b/Documentation/gitremote-helpers.txt
index be7e224..f1f4ca9 100644
--- a/Documentation/gitremote-helpers.txt
+++ b/Documentation/gitremote-helpers.txt
@@ -185,6 +185,12 @@ applicable refspec takes precedence. The left-hand of refspecs
advertised with this capability must cover all refs reported by
the list command. If no 'refspec' capability is advertised,
there is an implied `refspec *:*`.
+When writing remote-helpers for decentralized version control
+systems, it is advised to keep a local copy of the repository to
+interact with, and to let the private namespace refs point to this
+local repository, while the refs/remotes namespace is used to track
+the remote repository.
This modifies the 'import' capability.