1. Stefan Saasen
  2. git


Junio C Hamano  committed 352611f Merge

Merge branch 'jc/doc-long-options' into maint

* jc/doc-long-options:
gitcli: parse-options lets you omit tail of long options

  • Participants
  • Parent commits 26c21f8, 30462a7
  • Branches master

Comments (0)

Files changed (1)

File Documentation/gitcli.txt

View file
  • Ignore whitespace
 From the git 1.5.4 series and further, many git commands (not all of them at the
 time of the writing though) come with an enhanced option parser.
-Here is an exhaustive list of the facilities provided by this option parser.
+Here is a list of the facilities provided by this option parser.
 Magic Options
 `git clean -fdx`.
+Abbreviating long options
+Commands that support the enhanced option parser accepts unique
+prefix of a long option as if it is fully spelled out, but use this
+with a caution.  For example, `git commit --amen` behaves as if you
+typed `git commit --amend`, but that is true only until a later version
+of Git introduces another option that shares the same prefix,
+e.g `git commit --amenity" option.
 Separating argument from the option
 You can write the mandatory option parameter to an option as a separate