Re: [RFC PATCH] Write new giturl(7) manpage

On Mon, 29 Mar 2010, Ramkumar Ramachandra wrote:

Write a new manpage for documenting how different URLs are handled by
remote helpers.
---
 It severely lacks polish, but I thought I'd send in an early draft requesting
 comments. Also, I've made it more cryptic than Jonathan's revision and
 included more references.

 I'm not entirely happy with it because the remote vcs setting doesn't
 quite fit here. Plus, it seems like a dirty hack to me. The name doesn't do
 justice: giturl exists to host Ilari's remote helper notes. How can it be
 expanded to be more general?

 Why doesn't urls.txt document <transport>::<address> syntax? Should I
 fix this?

One useful way of answering questions like this is to find the commits 
that added the <transport>::<address> syntax (probably easiest with git 
blame), and at the commits that touched urls.txt (probably with git log), 
and see if the reading the messages makes it obvious. I'd guess (without 
actually looking myself) that it was just overlooked.

	-Daniel
*This .sig left intentionally blank*