Thread (7 messages) 7 messages, 3 authors, 2019-05-28
DORMANTno replies

[PATCH] doc branch: provide examples for listing remote tracking branches

From: Philip Oakley <hidden>
Date: 2019-05-28 12:13:25
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

The availability of these pattern selections is not obvious from
the man pages, as per mail thread [ref].

Provide examples.

Signed-off-by: Philip Oakley <redacted>
---

in response to 
[ref]
https://public-inbox.org/git/?q=%3CCACsJy8CwY8gzeWa9kNRX3ecez1JGiQiaOknbAoU7S%2BhiXBoUGQ%40mail.gmail.com%3E

to: "Git Mailing List <redacted>"
cc: "Duy Nguyen <redacted>"
cc: "Ævar Arnfjörð Bjarmason <redacted>"

 Documentation/git-branch.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)
diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt
index 3bd83a7cbd..7ed91f1be3 100644
--- a/Documentation/git-branch.txt
+++ b/Documentation/git-branch.txt
@@ -314,6 +314,18 @@ $ git branch -D test                                    <2>
 <2> Delete the "test" branch even if the "master" branch (or whichever branch
     is currently checked out) does not have all commits from the test branch.
 
+Listing branches from a specific remote::
++
+------------
+$ git branch -a -l '<remote>/<pattern>'                 <1>
+$ git for-each-ref 'refs/remotes/<remote>/<pattern>'    <2>
+------------
++
+<1> This can conflate <remote> with any local branches you happen to
+    have been prefixed with the same <remote> pattern.
+<2> `for-each-ref` can take a wide range of options. See linkgit:git-for-each-ref[1]
+
+Patterns will normally need quoting.
 
 NOTES
 -----
-- 
2.22.0.rc1.windows.1
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help