| 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. | 
| Junio C Hamano | 57827fb | 2010-01-23 03:02:50 | [diff] [blame] | 31 |  | 
|  | 32 | --no-notes:: | 
| Junio C Hamano | 3166736 | 2010-03-25 00:38:53 | [diff] [blame^] | 33 | --show-notes[=<ref>]:: | 
| Junio C Hamano | 57827fb | 2010-01-23 03:02:50 | [diff] [blame] | 34 | Show the notes (see linkgit:git-notes[1]) that annotate the | 
|  | 35 | commit, when showing the commit log message. This is the default | 
|  | 36 | for `git log`, `git show` and `git whatchanged` commands when | 
|  | 37 | there is no `--pretty`, `--format` nor `--oneline` option is | 
|  | 38 | given on the command line. | 
| Junio C Hamano | 3166736 | 2010-03-25 00:38:53 | [diff] [blame^] | 39 | + | 
|  | 40 | With an optional argument, add this ref to the list of notes. The ref | 
|  | 41 | is taken to be in `refs/notes/` if it is not qualified. | 
|  | 42 |  | 
|  | 43 | --[no-]standard-notes:: | 
|  | 44 | Enable or disable populating the notes ref list from the | 
|  | 45 | 'core.notesRef' and 'notes.displayRef' variables (or | 
|  | 46 | corresponding environment overrides). Enabled by default. | 
|  | 47 | See linkgit:git-config[1]. |