peel_onion(): add support for <rev>^{tag}
commit75aa26d34c4a80142512bd980a416b0fb30044c1
authorRichard Hansen <rhansen@bbn.com>
Tue, 3 Sep 2013 19:50:16 +0000 (3 15:50 -0400)
committerJunio C Hamano <gitster@pobox.com>
Tue, 3 Sep 2013 20:09:17 +0000 (3 13:09 -0700)
tree15871e0fb3d80909d16f9db8ef77108fb1c97d80
parente230c568c4b9a991e3175e5f65171a566fd8e39c
peel_onion(): add support for <rev>^{tag}

Complete the <rev>^{<type>} family of object descriptors by having
<rev>^{tag} dereference <rev> until a tag object is found (or fail if
unable).

At first glance this may not seem very useful, as commits, trees, and
blobs cannot be peeled to a tag, and a tag would just peel to itself.
However, this can be used to ensure that <rev> names a tag object:

    $ git rev-parse --verify v1.8.4^{tag}
    04f013dc38d7512eadb915eba22efc414f18b869
    $ git rev-parse --verify master^{tag}
    error: master^{tag}: expected tag type, but the object dereferences to tree type
    fatal: Needed a single revision

Users can already ensure that <rev> is a tag object by checking the
output of 'git cat-file -t <rev>', but:
  * users may expect <rev>^{tag} to exist given that <rev>^{commit},
    <rev>^{tree}, and <rev>^{blob} all exist
  * this syntax is more convenient/natural in some circumstances

Signed-off-by: Richard Hansen <rhansen@bbn.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/revisions.txt
sha1_name.c
t/t1511-rev-parse-caret.sh