docs/rev-list: add an examples section
authorJeff King <peff@peff.net>
Wed, 17 Feb 2021 23:34:21 +0000 (18:34 -0500)
committerJunio C Hamano <gitster@pobox.com>
Thu, 18 Feb 2021 00:22:13 +0000 (16:22 -0800)
commit669b4587555597da7f2a875b95dc50f503b8187f
tree6108c3a1fb94b6306b53e5aed86f08a390bf0373
parent16950f8384afa5106b1ce57da07a964c2aaef3f7
docs/rev-list: add an examples section

We currently don't show any examples of using git-rev-list at all. Let's
add some pretty elementary examples. They likely seem obvious to anybody
who has worked with the tool for a while, but my purpose here is
two-fold:

  - they may be enlightening to people who haven't used the tool a lot
    to give a general flavor of how it is meant to be used

  - they can serve as a starting point for adding more interesting
    examples (we can do that without the basic ones, of course, but I
    think it makes sense to show off the building blocks)

This set is far from exhaustive, but again, the purpose is to be a
starting point for further additions.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-rev-list.txt