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 Feb 3, 2021
1 parent 448e6a6 commit 295fdc1
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions Documentation/git-range-diff.txt
Expand Up @@ -28,6 +28,18 @@ 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 `<rev2>..<rev1> <rev1>..<rev2>`.

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

OPTIONS
-------
Expand Down

0 comments on commit 295fdc1

Please sign in to comment.