From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 21 Jun 2013 22:39:53 GMT
Subject: Re: [PATCH 10/16] ls-remote doc: rewrite <repository> paragraph
Message-ID: <7vfvwbjdfq.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1371813160-4200-11-git-send-email-artagnon@gmail.com>

Ramkumar Ramachandra <artagnon@gmail.com> writes:

> Replace the <repository> paragraph containing specific references to
> $GIT_DIR/branches and "." with a generic urls-or-remotes paragraph
> referencing the relevant sections in the git-fetch(1) manpage.
>
> Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
> ---
>  Documentation/git-ls-remote.txt | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/git-ls-remote.txt b/Documentation/git-ls-remote.txt
> index a24b8b6..0715892 100644
> --- a/Documentation/git-ls-remote.txt
> +++ b/Documentation/git-ls-remote.txt
> @@ -48,9 +48,9 @@ OPTIONS
>  	exit without talking to the remote.
>  
>  <repository>::
> -	Location of the repository.  The shorthand defined in
> -	$GIT_DIR/branches/ can be used. Use "." (dot) to list references in
> -	the local repository.
> +	The "remote" repository to query.  This parameter can be
> +	either a URL or the name of a remote (see the GIT URLS and
> +	REMOTES sections of linkgit:git-fetch[1]).

Looks OK.  "." was written before "for-each-ref" and "branch --list"
have become the standard way to list your local refs and branches,
and I would agree that the description outlived its usefulness.