Re: [RFC/PATCH 2/2] doc: command line interface (cli) dot-repository dwimmery

From: Jonathan Nieder <jrnieder@gmail.com>
Date: May 19, 2013, 17:39 UTC
Message-ID: <20130519173924.GB3362@elie.Belkin>
In-Reply-To: <1368964449-2724-3-git-send-email-philipoakley@iee.org>

Hi,

Philip Oakley wrote:

> The Git cli will generally accept dot '.' (period) as equivalent
> to the current repository when appropriate. Tell the reader of this
> 'do what I mean' (dwim)mery action.

[...]

Show 9 quoted lines

> --- a/Documentation/gitcli.txt
> +++ b/Documentation/gitcli.txt
> @@ -59,6 +59,10 @@ working tree.  After running `git add hello.c; rm hello.c`, you will _not_
>  see `hello.c` in your working tree with the former, but with the latter
>  you will.
>  
> +Just as, by convention, the filesystem '.' refers to the current directory,
> +using a '.' (period) as a repository name in Git (a dot-repository) refers
> +to your local repository.

Good idea, but I fear that no one would find it there.

Would it make sense to put this in Documentation/urls.txt (aka the "GIT URLS" section of git-fetch(1) and git-clone(1)), where other URL schemes are documented?

Thanks, Jonathan