| Junio C Hamano | d2179ef | 2010-10-22 04:12:17 | [diff] [blame] | 1 | --pretty[=<format>]:: | 
|  | 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', | 
| Junio C Hamano | e32ec8b | 2010-06-02 23:32:31 | [diff] [blame] | 6 | 'full', 'fuller', 'email', 'raw' and 'format:<string>'. See | 
|  | 7 | the "PRETTY FORMATS" section for some additional details for each | 
|  | 8 | format. When omitted, the format defaults to 'medium'. | 
| Junio C Hamano | 86bcccc | 2008-03-08 09:33:55 | [diff] [blame] | 9 | + | 
|  | 10 | Note: you can specify the default pretty format in the repository | 
|  | 11 | configuration (see linkgit:git-config[1]). | 
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 12 |  | 
| Junio C Hamano | ee695f2 | 2007-06-21 00:35:36 | [diff] [blame] | 13 | --abbrev-commit:: | 
|  | 14 | Instead of showing the full 40-byte hexadecimal commit object | 
| Junio C Hamano | 6efe302 | 2009-01-13 16:47:56 | [diff] [blame] | 15 | name, show only a partial prefix. Non default number of | 
| Junio C Hamano | ee695f2 | 2007-06-21 00:35:36 | [diff] [blame] | 16 | digits can be specified with "--abbrev=<n>" (which also modifies | 
|  | 17 | diff output, if it is displayed). | 
|  | 18 | + | 
|  | 19 | This should make "--pretty=oneline" a whole lot more readable for | 
|  | 20 | people using 80-column terminals. | 
|  | 21 |  | 
| Junio C Hamano | f93530e | 2011-05-25 23:59:59 | [diff] [blame] | 22 | --no-abbrev-commit:: | 
|  | 23 | Show the full 40-byte hexadecimal commit object name. This negates | 
|  | 24 | `--abbrev-commit` and those options which imply it such as | 
|  | 25 | "--oneline". It also overrides the 'log.abbrevCommit' variable. | 
|  | 26 |  | 
| Junio C Hamano | 0a23522 | 2009-03-06 08:21:09 | [diff] [blame] | 27 | --oneline:: | 
|  | 28 | This is a shorthand for "--pretty=oneline --abbrev-commit" | 
|  | 29 | used together. | 
|  | 30 |  | 
| Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 31 | --encoding[=<encoding>]:: | 
|  | 32 | The commit objects record the encoding used for the log message | 
|  | 33 | in their encoding header; this option can be used to tell the | 
|  | 34 | command to re-code the commit log message in the encoding | 
|  | 35 | preferred by the user. For non plumbing commands this | 
|  | 36 | defaults to UTF-8. | 
| Junio C Hamano | 57827fb | 2010-01-23 03:02:50 | [diff] [blame] | 37 |  | 
| Junio C Hamano | 6003346 | 2011-05-03 00:48:43 | [diff] [blame] | 38 | --notes[=<ref>]:: | 
| Junio C Hamano | 57827fb | 2010-01-23 03:02:50 | [diff] [blame] | 39 | Show the notes (see linkgit:git-notes[1]) that annotate the | 
|  | 40 | commit, when showing the commit log message. This is the default | 
|  | 41 | for `git log`, `git show` and `git whatchanged` commands when | 
| Junio C Hamano | 6003346 | 2011-05-03 00:48:43 | [diff] [blame] | 42 | there is no `--pretty`, `--format` nor `--oneline` option given | 
|  | 43 | on the command line. | 
| Junio C Hamano | 3166736 | 2010-03-25 00:38:53 | [diff] [blame] | 44 | + | 
| Junio C Hamano | 6003346 | 2011-05-03 00:48:43 | [diff] [blame] | 45 | By default, the notes shown are from the notes refs listed in the | 
|  | 46 | 'core.notesRef' and 'notes.displayRef' variables (or corresponding | 
|  | 47 | environment overrides). See linkgit:git-config[1] for more details. | 
|  | 48 | + | 
|  | 49 | With an optional '<ref>' argument, show this notes ref instead of the | 
|  | 50 | default notes ref(s). The ref is taken to be in `refs/notes/` if it | 
|  | 51 | is not qualified. | 
|  | 52 | + | 
|  | 53 | Multiple --notes options can be combined to control which notes are | 
|  | 54 | being displayed. Examples: "--notes=foo" will show only notes from | 
|  | 55 | "refs/notes/foo"; "--notes=foo --notes" will show both notes from | 
|  | 56 | "refs/notes/foo" and from the default notes ref(s). | 
| Junio C Hamano | 3166736 | 2010-03-25 00:38:53 | [diff] [blame] | 57 |  | 
| Junio C Hamano | 6003346 | 2011-05-03 00:48:43 | [diff] [blame] | 58 | --no-notes:: | 
|  | 59 | Do not show notes. This negates the above `--notes` option, by | 
|  | 60 | resetting the list of notes refs from which notes are shown. | 
|  | 61 | Options are parsed in the order given on the command line, so e.g. | 
|  | 62 | "--notes --notes=foo --no-notes --notes=bar" will only show notes | 
|  | 63 | from "refs/notes/bar". | 
|  | 64 |  | 
|  | 65 | --show-notes[=<ref>]:: | 
| Junio C Hamano | 3166736 | 2010-03-25 00:38:53 | [diff] [blame] | 66 | --[no-]standard-notes:: | 
| Junio C Hamano | 6003346 | 2011-05-03 00:48:43 | [diff] [blame] | 67 | These options are deprecated. Use the above --notes/--no-notes | 
|  | 68 | options instead. | 
| Junio C Hamano | 0acb1ae | 2012-09-24 21:28:13 | [diff] [blame] | 69 |  | 
|  | 70 | --show-signature:: | 
|  | 71 | Check the validity of a signed commit object by passing the signature | 
|  | 72 | to `gpg --verify` and show the output. |