| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 1 | --pretty[='<format>']:: |
| Junio C Hamano | 0a23522 | 2009-03-06 08:21:09 | [diff] [blame] | 2 | --format[='<format>']:: |
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 3 | |
| Junio C Hamano | a3770f9 | 2007-07-25 08:53:33 | [diff] [blame] | 4 | Pretty-print the contents of the commit logs in a given format, |
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 5 | where '<format>' can be one of 'oneline', 'short', 'medium', |
| 6 | 'full', 'fuller', 'email', 'raw' and 'format:<string>'. |
| Junio C Hamano | a3770f9 | 2007-07-25 08:53:33 | [diff] [blame] | 7 | When omitted, the format defaults to 'medium'. |
| Junio C Hamano | 86bcccc | 2008-03-08 09:33:55 | [diff] [blame] | 8 | + |
| 9 | Note: you can specify the default pretty format in the repository |
| 10 | configuration (see linkgit:git-config[1]). |
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 11 | |
| Junio C Hamano | ee695f2 | 2007-06-21 00:35:36 | [diff] [blame] | 12 | --abbrev-commit:: |
| 13 | Instead of showing the full 40-byte hexadecimal commit object |
| Junio C Hamano | 6efe302 | 2009-01-13 16:47:56 | [diff] [blame] | 14 | name, show only a partial prefix. Non default number of |
| Junio C Hamano | ee695f2 | 2007-06-21 00:35:36 | [diff] [blame] | 15 | digits can be specified with "--abbrev=<n>" (which also modifies |
| 16 | diff output, if it is displayed). |
| 17 | + |
| 18 | This should make "--pretty=oneline" a whole lot more readable for |
| 19 | people using 80-column terminals. |
| 20 | |
| Junio C Hamano | 0a23522 | 2009-03-06 08:21:09 | [diff] [blame] | 21 | --oneline:: |
| 22 | This is a shorthand for "--pretty=oneline --abbrev-commit" |
| 23 | used together. |
| 24 | |
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 25 | --encoding[=<encoding>]:: |
| 26 | The commit objects record the encoding used for the log message |
| 27 | in their encoding header; this option can be used to tell the |
| 28 | command to re-code the commit log message in the encoding |
| 29 | preferred by the user. For non plumbing commands this |
| 30 | defaults to UTF-8. |