Skip to content
  • Richard Hansen's avatar
    peel_onion(): add support for <rev>^{tag} · 75aa26d3
    Richard Hansen authored and Junio C Hamano's avatar Junio C Hamano committed
    
    
    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: default avatarRichard Hansen <rhansen@bbn.com>
    Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
    75aa26d3