Skip to content

Commit

Permalink
range-diff(docs): explain how to specify commit ranges
Browse files Browse the repository at this point in the history
There are three forms, depending whether the user specifies one, two or
three non-option arguments. We've never actually explained how this
works in the manual, so let's explain it.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
  • Loading branch information
dscho committed Jan 22, 2021
1 parent 577d0ca commit 33d6b9c
Showing 1 changed file with 13 additions and 0 deletions.
13 changes: 13 additions & 0 deletions Documentation/git-range-diff.txt
Expand Up @@ -28,6 +28,19 @@ Finally, the list of matching commits is shown in the order of the
second commit range, with unmatched commits being inserted just after
all of their ancestors have been shown.

There are three ways to specify the commit ranges:

- `<range1> <range2>`: Either commit range can be of the form
`<base>..<rev>`, `<rev>^!` or `<rev>^-<n>`. See `SPECIFYING RANGES`
in linkgit:gitrevisions[7] for more details.

- `<rev1>...<rev2>`. This resembles the symmetric ranges mentioned in
the `SPECIFYING RANGES` section of linkgit:gitrevisions[7], and is
equivalent to `<base>..<rev1> <base>..<rev2>` where `<base>` is the
merge base as obtained via `git merge-base <rev1> <rev2>`.

- `<base> <rev1> <rev2>`: This is equivalent to `<base>..<rev1>
<base>..<rev2>`.

OPTIONS
-------
Expand Down

0 comments on commit 33d6b9c

Please sign in to comment.