| 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. |