Merge branch 'rr/name-rev-stdin-doc'

* rr/name-rev-stdin-doc:
name-rev doc: rewrite --stdin paragraph

diff --combined Documentation/git-name-rev.txt
index 6b0f1ba75fc98dedf7b940355274ad25d3b458c5,11da704b8d36089ad54c35dc27ed013d65fb8cc0..15b00e09916fff47a8244432ce396c9b6f7fbec1
--- 1/Documentation/git-name-rev.txt
--- 2/Documentation/git-name-rev.txt
+++ b/Documentation/git-name-rev.txt
@@@ -25,15 -25,16 +25,17 @@@ OPTION
        Do not use branch names, but only tags to name the commits
  
  --refs=<pattern>::
 -      Only use refs whose names match a given shell pattern.
 +      Only use refs whose names match a given shell pattern.  The pattern
 +      can be one of branch name, tag name or fully qualified ref name.
  
  --all::
        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