From: Junio C Hamano <gitster@pobox.com>
Date: Sun, 07 Jul 2013 18:04:27 GMT
Subject: Re: [PATCH 3/3] name-rev doc: rewrite --stdin paragraph
Message-ID: <7vhag64578.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1373200996-9753-4-git-send-email-artagnon@gmail.com>

Ramkumar Ramachandra <artagnon@gmail.com> writes:

> Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
> ---
>  Documentation/git-name-rev.txt | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/git-name-rev.txt b/Documentation/git-name-rev.txt
> index 7cde4b3..94bded8 100644
> --- a/Documentation/git-name-rev.txt
> +++ b/Documentation/git-name-rev.txt
> @@ -32,8 +32,10 @@ OPTIONS
>  	List all commits reachable from all refs
>  
>  --stdin::
> -	Read from stdin, append "(<rev_name>)" to all sha1's of nameable
> -	commits, and pass to stdout
> +	Transform stdin by substituting all the 40-character SHA-1
> +	hexes (say $hex) with "$hex ($rev_name)".  When used with
> +	--name-only, substitute with "$rev_name", omitting $hex
> +	altogether.  Intended for the scripter's use.
>  
>  --name-only::
>  	Instead of printing both the SHA-1 and the name, print only

Looks obviously correct and more helpful description.

Thanks.