Re: [PATCH v2] Documentation/remote-helpers: Add invocation section

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Mar 30, 2010, 20:25 UTC
Message-ID: <20100330202511.GC10977@progeny.tock>
In-Reply-To: <f3271551003301315i4bee002dm572e179819dbb1cd@mail.gmail.com>

Ramkumar Ramachandra wrote:

Show 13 quoted lines

> On Wed, Mar 31, 2010 at 1:40 AM, Ilari Liusvaara wrote:
>> 'tls://srp-Ilari@[1067a6e3af81b5ea76d615280eee2bc3dd2e8079@tcp/ipv6~fe80::20e:a6ff:fe6f:2288%2]:7684/gitolite-admin'
> 
> On Wed, Mar 31, 2010 at 1:29 AM, Jonathan Nieder <jrnieder@gmail.com> wrote:
>> What I meant by "arbitrary string" is that it doesn’t have to have the
>> form schema://path, it’s not restricted to a particular character set,
>> it doesn’t have to avoid conflicting with meaningful URLs defined by
>> other helpers, and so on.  So it’s a resource locator but not very
>> uniform.
>
> Well, we're trying to document all these "urls" in urls.txt [1]. I
> should perhaps use the term "URL recognized by Git" and include a link
> to the urls page in the documentation?

Hmm. urls.txt is not currently its own page; instead, it is included in git-clone(1) and so on. I hope to change that this weekend.

More to the point, wouldn’t "URL recognized by Git" mean a string like fd::3,4 rather than the 3,4 that is passed to ‘git remote-fd’?

Also worth keeping in mind: we want to support third-party helpers, too. So it is hard to have one centralized document that completely explains all possible URLs.

Jonathan