Skip to contentSkip to conversation

'git show-ref <pattern>' doesn't work (shows nothing)

BUG In review Jakub Narebski 2 participants 3 messages Jun 15, 2016 Documentation

lore
Share & tools
lore
#0 lore raw

In the git-show-ref documentation we read:

git-show-ref - List references in a local repository

  SYNOPSIS
  --------
  [verse]
  'git show-ref' [-q|--quiet] [--verify] [--head] [-d|--dereference]
               [-s|--hash[=<n>]] [--abbrev[=<n>]] [--tags]
               [--heads] [--] [<pattern>...]
  'git show-ref' --exclude-existing[=<pattern>] < ref-list

DESCRIPTION
-----------

Displays references available in a local repository along with the associated commit IDs. Results can be filtered using a pattern and tags can be dereferenced into object IDs. Additionally, it can be used to test whether a particular ref exists.

Let's overlook the fact that the using '--verify' is a separate way of operation, and should be given seperate line in synopsis.

What is more important is that filtering using pattern doesn't work. All of commands listed below produce empty output:

  $ git show-ref refs/heads
  $ git show-ref refs/heads/
  $ git show-ref 'refs/heads/*'
  $ git show-ref -- refs/heads
  $ git show-ref -- 'refs/heads/*'

Note that using '--heads' gives output:

  $ git show-ref --heads
  01cc740941a6b81fd7be03484c83f688dc79a5f2 refs/heads/Git.pm
  23b2a0387f0acd7e3cd906a0dc3c2c23dd32c03d refs/heads/autoconf
  [...]

but I am more interested in patterns like 'refs/heads/gitweb/', or 'refs/remotes/origin/', or 'refs/tags/v*'.

For the time of being I'd have to use git-for-each-ref instead:

  $ git for-each-ref refs/heads/
  01cc740941a6b81fd7be03484c83f688dc79a5f2 commit refs/heads/Git.pm
  23b2a0387f0acd7e3cd906a0dc3c2c23dd32c03d commit refs/heads/autoconf

(though to get same output I'd have to use appropriate <format>).

Signature · 2 lines
Jakub Narebski
Poland
#1 lore raw

PATCH 1/1 git-show-ref.txt: clarify the pattern matching

git-show-ref really does not do what one would expect under the name pattern matching, so describe it.

---
 Documentation/git-show-ref.txt |    6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)
Documentation/git-show-ref.txt +5 -1
index 4696af7..be0ec18 100644
@@ -84,7 +84,11 @@ OPTIONS
 
 <pattern>...::
 
-	Show references matching one or more patterns.
+	Show references matching one or more patterns. Patterns are matched from
+	the end of the full name, and only complete parts are matched, e.g.
+	'master' matches 'refs/heads/master', 'refs/remotes/origin/master',
+	'refs/tags/jedi/master' but not 'refs/heads/mymaster' nor
+	'refs/remotes/master/jedi'.
 
 OUTPUT
 ------
Signature · 1 line
1.7.3.1.208.g53ea2
#2 lore raw

Re: [PATCH] git-show-ref.txt: clarify the pattern matching

Quoted 4 lines · Michael J Gruber

git-show-ref really does not do what one would expect under the name pattern matching, so describe it.

Thanks a lot! That clarifies it.

Signature · 2 lines
Jakub Narebski
Poland