Document git log --abbrev-commit, as a kind of pretty option
authorJakub Narebski <jnareb@gmail.com>
Sat, 16 Jun 2007 19:03:39 +0000 (21:03 +0200)
committerJunio C Hamano <gitster@pobox.com>
Sat, 16 Jun 2007 20:10:49 +0000 (13:10 -0700)
Documentation taken from paraphrased description of "--abbrev[=<n>]"
diff option, and from description of commit 5c51c985 introducing
this option.

Note that to change number of digits one must use "--abbrev=<n>",
which affects [also] diff output.

Signed-off-by: Jakub Narebski <jnareb@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/pretty-options.txt

index 6338def5a795a8171286626752a96f8ac88842c8..746bc5b7f9a3f96ea321586e095a4fc8ccb6e73f 100644 (file)
@@ -5,6 +5,15 @@
        'full', 'fuller', 'email', 'raw' and 'format:<string>'.
        When left out the format default to 'medium'.
 
+--abbrev-commit::
+       Instead of showing the full 40-byte hexadecimal commit object
+       name, show only handful hexdigits prefix.  Non default number of
+       digits can be specified with "--abbrev=<n>" (which also modifies
+       diff output, if it is displayed).
++
+This should make "--pretty=oneline" a whole lot more readable for
+people using 80-column terminals.
+
 --encoding[=<encoding>]::
        The commit objects record the encoding used for the log message
        in their encoding header; this option can be used to tell the