1 files changed, 52 insertions, 17 deletions
diff --git a/git-ls-remote.html b/git-ls-remote.html
index e5de75891..90781ddd3 100644
--- a/git-ls-remote.html
+++ b/git-ls-remote.html
@@ -911,28 +911,63 @@ commit IDs.</p></div>
 </div>
 </div>
 <div class="sect1">
+<h2 id="_output">OUTPUT</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The output is in the format:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>&lt;oid&gt; TAB &lt;ref&gt; LF</code></pre>
+</div></div>
+<div class="paragraph"><p>When showing an annotated tag, unless <code>--refs</code> is given, two such
+lines are shown: one with the refname for the tag itself as <code>&lt;ref&gt;</code>,
+and another with <code>&lt;ref&gt;</code> followed by <code>^{}</code>. The <code>&lt;oid&gt;</code> on the latter
+line shows the name of the object the tag points at.</p></div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_examples">EXAMPLES</h2>
 <div class="sectionbody">
+<div class="ulist"><ul>
+<li>
+<p>
+List all references (including symbolics and pseudorefs), peeling
+  tags:
+</p>
 <div class="listingblock">
 <div class="content">
-<pre><code>$ git ls-remote --tags .
-d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
-f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
-7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3
-c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
-0918385dbd9656cab0d1d81ba7453d49bbc16250        refs/tags/junio-gpg-pub
-
-$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
+<pre><code>$ git ls-remote
+27d43aaaf50ef0ae014b88bba294f93658016a2e        HEAD
+950264636c68591989456e3ba0a5442f93152c1a        refs/heads/main
+d9ab777d41f92a8c1684c91cfb02053d7dd1046b        refs/heads/next
+d4ca2e3147b409459955613c152220f4db848ee1        refs/tags/v2.40.0
+73876f4861cd3d187a4682290ab75c9dccadbc56        refs/tags/v2.40.0^{}</code></pre>
+</div></div>
+</li>
+<li>
+<p>
+List all references matching given patterns:
+</p>
+<div class="listingblock">
+<div class="content">
+<pre><code>$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
 5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master
-c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/seen
-
-$ git remote add korg http://www.kernel.org/pub/scm/git/git.git
-$ git ls-remote --tags korg v\*
-d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
-f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
-c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
-7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3</code></pre>
+c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/seen</code></pre>
+</div></div>
+</li>
+<li>
+<p>
+List only tags matching a given wildcard pattern:
+</p>
+<div class="listingblock">
+<div class="content">
+<pre><code>$ git ls-remote --tags http://www.kernel.org/pub/scm/git/git.git v\*
+485a869c64a68cc5795dd99689797c5900f4716d        refs/tags/v2.39.2
+cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6        refs/tags/v2.39.2^{}
+d4ca2e3147b409459955613c152220f4db848ee1        refs/tags/v2.40.0
+73876f4861cd3d187a4682290ab75c9dccadbc56        refs/tags/v2.40.0^{}</code></pre>
 </div></div>
+</li>
+</ul></div>
 </div>
 </div>
 <div class="sect1">
@@ -952,7 +987,7 @@ c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2023-02-23 08:29:29 JST
+ 2023-06-13 13:57:42 PDT
 </div>
 </div>
 </body>