Note: you can specify the default pretty format in the repository configuration (see git-config(1)).

This should make "--pretty=oneline" a whole lot more readable for people using 80-column terminals.

With an optional argument, add this ref to the list of notes. The ref is taken to be in refs/notes/ if it is not qualified.

--date=relative shows dates relative to the current time, e.g. "2 hours ago".

--date=local shows timestamps in user’s local timezone.

--date=iso (or --date=iso8601) shows timestamps in ISO 8601 format.

--date=rfc (or --date=rfc2822) shows timestamps in RFC 2822 format, often found in E-mail messages.

--date=short shows only date but not time, in YYYY-MM-DD format.

--date=raw shows the date in the internal raw git format %s %z format.

--date=default shows timestamps in the original timezone (either committer’s or author’s).

For example, if you have this topology:

             y---b---b  branch B


            / \ /


           /   .


          /   / \


         o---x---a---a  branch A

you would get an output like this:

        $ git rev-list --left-right --boundary --pretty=oneline A...B


        >bbbbbbb... 3rd on b


        >bbbbbbb... 2nd on b


        <aaaaaaa... 3rd on a


        <aaaaaaa... 2nd on a


        -yyyyyyy... 1st on b


        -xxxxxxx... 1st on a

This implies the --topo-order option by default, but the --date-order option may also be specified.

For example, if you have two branches, A and B, a usual way to list all commits on only one side of them is with --left-right, like the example above in the description of that option. It however shows the commits that were cherry-picked from the other branch (for example, "3rd on b" may be cherry-picked from branch A). With this option, such pairs of commits are excluded from the output.

With --pretty format other than oneline (for obvious reasons), this causes the output to have two extra lines of information taken from the reflog. By default, commit@{Nth} notation is used in the output. When the starting commit is specified as commit@{now}, output also uses commit@{timestamp} notation instead. Under --pretty=oneline, the commit message is prefixed with this information on the same line. This option cannot be combined with --reverse. See also git-reflog(1).

          .-A---M---N---O---P


         /     /   /   /   /


        I     B   C   D   E


         \   /   /   /   /


          `-------------´

This results in:

          .-A---N---O


         /         /


        I---------D

Note how the rule to only follow the TREESAME parent, if one is available, removed B from consideration entirely. C was considered via N, but is TREESAME. Root commits are compared to an empty tree, so I is !TREESAME.

Parent/child relations are only visible with --parents, but that does not affect the commits selected in default mode, so we have shown the parent lines.

        I  A  B  N  D  O

P and M were excluded because they are TREESAME to a parent. E, C and B were all walked, but only B was !TREESAME, so the others do not appear.

Note that without parent rewriting, it is not really possible to talk about the parent/child relationships between the commits, so we show them disconnected.

Merges are always included. However, their parent list is rewritten: Along each parent, prune away commits that are not included themselves. This results in

          .-A---M---N---O---P


         /     /   /   /   /


        I     B   /   D   /


         \   /   /   /   /


          `-------------´

Compare to --full-history without rewriting above. Note that E was pruned away because it is TREESAME, but the parent list of P was rewritten to contain E´s parent I. The same happened for C and N. Note also that P was included despite being TREESAME.

Note that without --full-history, this still simplifies merges: if one of the parents is TREESAME, we follow only that one, so the other sides of the merge are never walked.

Then simplify each commit ‘C` to its replacement C’ in the final history according to the following rules:

          .-A---M---N---O


         /     /       /


        I     B       D


         \   /       /


          `---------´

The --simplify-by-decoration option allows you to view only the big picture of the topology of the history, by omitting commits that are not referenced by tags. Commits are marked as !TREESAME (in other words, kept after history simplification rules described above) if (1) they are referenced by tags, or (2) they change the contents of the paths given on the command line. All other commits are marked as TREESAME (subject to be simplified away).

        $ git rev-list --bisect foo ^bar ^baz

        $ git rev-list foo ^midpoint


        $ git rev-list midpoint ^bar ^baz

This is useful because it makes it easy to choose a good commit to test when you want to avoid to test some of them for some reason (they may not compile for example).

This option can be used along with --bisect-vars, in this case, after all the sorted commit objects, there will be the same text as if --bisect-vars had been used alone.