edbb02f18c13c6fb93e594426f4c3173bdedf603
   1--pretty[=<format>]::
   2--format=<format>::
   3
   4        Pretty-print the contents of the commit logs in a given format,
   5        where '<format>' can be one of 'oneline', 'short', 'medium',
   6        'full', 'fuller', 'email', 'raw', 'format:<string>'
   7        and 'tformat:<string>'.  When '<format>' is none of the above,
   8        and has '%placeholder' in it, it acts as if
   9        '--pretty=tformat:<format>' were given.
  10+
  11See the "PRETTY FORMATS" section for some additional details for each
  12format.  When '=<format>' part is omitted, it defaults to 'medium'.
  13+
  14Note: you can specify the default pretty format in the repository
  15configuration (see linkgit:git-config[1]).
  16
  17--abbrev-commit::
  18        Instead of showing the full 40-byte hexadecimal commit object
  19        name, show only a partial prefix.  Non default number of
  20        digits can be specified with "--abbrev=<n>" (which also modifies
  21        diff output, if it is displayed).
  22+
  23This should make "--pretty=oneline" a whole lot more readable for
  24people using 80-column terminals.
  25
  26--no-abbrev-commit::
  27        Show the full 40-byte hexadecimal commit object name. This negates
  28        `--abbrev-commit` and those options which imply it such as
  29        "--oneline". It also overrides the 'log.abbrevCommit' variable.
  30
  31--oneline::
  32        This is a shorthand for "--pretty=oneline --abbrev-commit"
  33        used together.
  34
  35--encoding=<encoding>::
  36        The commit objects record the encoding used for the log message
  37        in their encoding header; this option can be used to tell the
  38        command to re-code the commit log message in the encoding
  39        preferred by the user.  For non plumbing commands this
  40        defaults to UTF-8. Note that if an object claims to be encoded
  41        in `X` and we are outputting in `X`, we will output the object
  42        verbatim; this means that invalid sequences in the original
  43        commit may be copied to the output.
  44
  45--expand-tabs::
  46--no-expand-tabs::
  47        Perform a tab expansion (replace each tab with enough spaces
  48        to fill to the next display column that is multiple of 8)
  49        in the log message before showing it in the output.
  50+
  51By default, tabs are expanded in pretty formats that indent the log
  52message by 4 spaces (i.e.  'medium', which is the default, 'full',
  53and 'fuller').  `--no-expand-tabs` option can be used to disable
  54this.
  55
  56ifndef::git-rev-list[]
  57--notes[=<ref>]::
  58        Show the notes (see linkgit:git-notes[1]) that annotate the
  59        commit, when showing the commit log message.  This is the default
  60        for `git log`, `git show` and `git whatchanged` commands when
  61        there is no `--pretty`, `--format`, or `--oneline` option given
  62        on the command line.
  63+
  64By default, the notes shown are from the notes refs listed in the
  65'core.notesRef' and 'notes.displayRef' variables (or corresponding
  66environment overrides). See linkgit:git-config[1] for more details.
  67+
  68With an optional '<ref>' argument, show this notes ref instead of the
  69default notes ref(s). The ref specifies the full refname when it begins
  70with `refs/notes/`; when it begins with `notes/`, `refs/` and otherwise
  71`refs/notes/` is prefixed to form a full name of the ref.
  72+
  73Multiple --notes options can be combined to control which notes are
  74being displayed. Examples: "--notes=foo" will show only notes from
  75"refs/notes/foo"; "--notes=foo --notes" will show both notes from
  76"refs/notes/foo" and from the default notes ref(s).
  77
  78--no-notes::
  79        Do not show notes. This negates the above `--notes` option, by
  80        resetting the list of notes refs from which notes are shown.
  81        Options are parsed in the order given on the command line, so e.g.
  82        "--notes --notes=foo --no-notes --notes=bar" will only show notes
  83        from "refs/notes/bar".
  84
  85--show-notes[=<ref>]::
  86--[no-]standard-notes::
  87        These options are deprecated. Use the above --notes/--no-notes
  88        options instead.
  89endif::git-rev-list[]
  90
  91--show-signature::
  92        Check the validity of a signed commit object by passing the signature
  93        to `gpg --verify` and show the output.