Merge branch 'ib/rev-parse-parseopt-argh'

Finishing touch to a new topic scheduled for 2.0.

* ib/rev-parse-parseopt-argh:
rev-parse: fix typo in example on manpage

diff --combined Documentation/git-rev-parse.txt
index c452f33a366fd1c85da8e4288fa6722263545a55,377d9d72359df834cdb666f6c2a74f8be84f8a91..987395d22af915832c535840ef59927fc5125294
--- 1/Documentation/git-rev-parse.txt
--- 2/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@@@ -290,14 -290,14 +290,14 @@@ The lines after the separator describe 
  Each line of options has this format:
  
  ------------
 -<opt_spec><flags>*<arg_hint>? SP+ help LF
 +<opt-spec><flags>*<arg-hint>? SP+ help LF
  ------------
  
 -`<opt_spec>`::
 +`<opt-spec>`::
        its format is the short option character, then the long option name
        separated by a comma. Both parts are not required, though at least one
        is necessary. `h,help`, `dry-run` and `f` are all three correct
 -      `<opt_spec>`.
 +      `<opt-spec>`.
  
  `<flags>`::
        `<flags>` are of `*`, `=`, `?` or `!`.
@@@ -313,11 -313,11 +313,11 @@@
  
        * Use `!` to not make the corresponding negated long option available.
  
 -`<arg_hint>`::
 -      `<arg_hint>`, if specified, is used as a name of the argument in the
 -      help output, for options that take arguments. `<arg_hint>` is
 -      terminated by the first whitespace. When you need to use space in the
 -      argument hint use dash instead.
 +`<arg-hint>`::
 +      `<arg-hint>`, if specified, is used as a name of the argument in the
 +      help output, for options that take arguments. `<arg-hint>` is
 +      terminated by the first whitespace.  It is customary to use a
 +      dash to separate words in a multi-word argument hint.
  
  The remainder of the line, after stripping the spaces, is used
  as the help associated to the option.
@@@ -363,7 -363,7 +363,7 @@@ usage: some-command [options] <args>..
      -h, --help            show the help
      --foo                 some nifty option --foo
      --bar ...             some cool option --bar with an argument
-     --bar <arg>           another cool option --baz with a named argument
+     --baz <arg>           another cool option --baz with a named argument
      --qux[=<path>]        qux may take a path argument but has meaning by itself
  
  An option group Header