Skip to content

Commit 2cc543d

Browse files
dschogitster
authored andcommitted
range-diff(docs): explain how to specify commit ranges
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 <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 359f0d7 commit 2cc543d

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

Documentation/git-range-diff.txt

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,17 @@ Finally, the list of matching commits is shown in the order of the
2828
second commit range, with unmatched commits being inserted just after
2929
all of their ancestors have been shown.
3030

31+
There are three ways to specify the commit ranges:
32+
33+
- `<range1> <range2>`: Either commit range can be of the form
34+
`<base>..<rev>`, `<rev>^!` or `<rev>^-<n>`. See `SPECIFYING RANGES`
35+
in linkgit:gitrevisions[7] for more details.
36+
37+
- `<rev1>...<rev2>`. This is equivalent to
38+
`<rev2>..<rev1> <rev1>..<rev2>`.
39+
40+
- `<base> <rev1> <rev2>`: This is equivalent to `<base>..<rev1>
41+
<base>..<rev2>`.
3142

3243
OPTIONS
3344
-------

0 commit comments

Comments
 (0)