undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation/remote-helpers: document common use-case for private ref

Browse Source 
The current documentation mentions the private ref namespace, but does
not really explain why it can be useful.

Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Matthieu Moy 2013-08-26 11:21:39 +02:00 committed by Junio C Hamano
parent e230c568c4
commit 3f36eb4305
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/gitremote-helpers.txt
View File

@ -176,6 +176,12 @@ applicable refspec takes precedence. The left-hand of refspecs
advertised with this capability must cover all refs reported by advertised with this capability must cover all refs reported by
the list command. If no 'refspec' capability is advertised, the list command. If no 'refspec' capability is advertised,
there is an implied `refspec *:*`. 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.
'bidi-import':: 'bidi-import'::
This modifies the 'import' capability. This modifies the 'import' capability.