Autogenerated HTML docs for v1.4.3.3-g15160
authorJunio C Hamano <junio@hera.kernel.org>
Sat, 28 Oct 2006 21:29:01 +0000 (21:29 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Sat, 28 Oct 2006 21:29:01 +0000 (21:29 +0000)
git-for-each-ref.html
git-for-each-ref.txt
git.html
git.txt

index 3c4ee272bee4330489a324718520dbd660c7f2b5..5953edda9c863e3cb0e371764afdea2775854332 100644 (file)
@@ -272,14 +272,14 @@ git-for-each-ref(1) Manual Page
 </div>\r
 <h2>SYNOPSIS</h2>\r
 <div class="sectionbody">\r
-<p><em>git-for-each-ref</em> [--count=&lt;count&gt;]<strong> [--shell|--perl|--python] [--sort=&lt;key&gt;]</strong> [--format=&lt;format&gt;] [&lt;pattern&gt;]</p>\r
+<p><em>git-for-each-ref</em> [--count=&lt;count&gt;]* [--shell|--perl|--python] [--sort=&lt;key&gt;]* [--format=&lt;format&gt;] [&lt;pattern&gt;]</p>\r
 </div>\r
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
 <p>Iterate over all refs that match <tt>&lt;pattern&gt;</tt> and show them\r
 according to the given <tt>&lt;format&gt;</tt>, after sorting them according\r
-to the given set of <tt>&lt;key&gt;`s.  If </tt>&lt;max&gt;<tt> is given, stop after\r
-showing that many refs.  The interporated values in </tt>&lt;format&gt;`\r
+to the given set of <tt>&lt;key&gt;</tt>.  If <tt>&lt;max&gt;</tt> is given, stop after\r
+showing that many refs.  The interporated values in <tt>&lt;format&gt;</tt>\r
 can optionally be quoted as string literals in the specified\r
 host language allowing their direct evaluation in that language.</p>\r
 </div>\r
@@ -317,7 +317,11 @@ host language allowing their direct evaluation in that language.</p>
         is prefixed with an asterisk (<tt>*</tt>) and the ref points\r
         at a tag object, the value for the field in the object\r
         tag refers is used.  When unspecified, defaults to\r
-        <tt>%(refname)</tt>.\r
+        <tt>%(objectname) SPC %(objecttype) TAB %(refname)</tt>.\r
+        It also interpolates <tt>%%</tt> to <tt>%</tt>, and <tt>%xx</tt> where <tt>xx</tt>\r
+        are hex digits interpolates to character with hex code\r
+        <tt>xx</tt>; for example <tt>%00</tt> interpolates to <tt>\0</tt> (NUL),\r
+        <tt>%09</tt> to <tt>\t</tt> (TAB) and <tt>%0a</tt> to <tt>\n</tt> (LF).\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -484,7 +488,7 @@ eval "$eval"</tt></pre>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 25-Oct-2006 22:55:22 UTC\r
+Last updated 28-Oct-2006 21:28:52 UTC\r
 </div>\r
 </div>\r
 </body>\r
index d5fdcef8d9e60d061ed83a8388ad1d3d0a47e6a5..2bf6aef73522e3ba7e5212d3eb1bce02a257e069 100644 (file)
@@ -7,14 +7,14 @@ git-for-each-ref - Output information on each ref
 
 SYNOPSIS
 --------
-'git-for-each-ref' [--count=<count>]* [--shell|--perl|--python] [--sort=<key>]* [--format=<format>] [<pattern>]
+'git-for-each-ref' [--count=<count>]\* [--shell|--perl|--python] [--sort=<key>]\* [--format=<format>] [<pattern>]
 
 DESCRIPTION
 -----------
 
 Iterate over all refs that match `<pattern>` and show them
 according to the given `<format>`, after sorting them according
-to the given set of `<key>`s.  If `<max>` is given, stop after
+to the given set of `<key>`.  If `<max>` is given, stop after
 showing that many refs.  The interporated values in `<format>`
 can optionally be quoted as string literals in the specified
 host language allowing their direct evaluation in that language.
@@ -38,7 +38,11 @@ OPTIONS
        is prefixed with an asterisk (`*`) and the ref points
        at a tag object, the value for the field in the object
        tag refers is used.  When unspecified, defaults to
-       `%(refname)`.
+       `%(objectname) SPC %(objecttype) TAB %(refname)`.
+       It also interpolates `%%` to `%`, and `%xx` where `xx`
+       are hex digits interpolates to character with hex code
+       `xx`; for example `%00` interpolates to `\0` (NUL),
+       `%09` to `\t` (TAB) and `%0a` to `\n` (LF).
 
 <pattern>::
        If given, the name of the ref is matched against this
index 757b07c39c729788826f2bef661148094f55f55f..b16a005d10bd6bec8f45a68478502aefb4bd556f 100644 (file)
--- a/git.html
+++ b/git.html
@@ -558,6 +558,14 @@ repositories.</p>
 </p>\r
 </dd>\r
 <dt>\r
+<a href="git-for-each-ref.html">git-for-each-ref(1)</a>\r
+</dt>\r
+<dd>\r
+<p>\r
+        Output information on each ref.\r
+</p>\r
+</dd>\r
+<dt>\r
 <a href="git-fsck-objects.html">git-fsck-objects(1)</a>\r
 </dt>\r
 <dd>\r
@@ -2182,7 +2190,7 @@ contributors on the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 25-Oct-2006 22:55:22 UTC\r
+Last updated 28-Oct-2006 21:28:52 UTC\r
 </div>\r
 </div>\r
 </body>\r
diff --git a/git.txt b/git.txt
index b00607ee1b836e2cdcb033e55ca18214d91cb3b9..595cca1efda159390149bfcaf96084520ef738e3 100644 (file)
--- a/git.txt
+++ b/git.txt
@@ -160,6 +160,9 @@ gitlink:git-diff-stages[1]::
 gitlink:git-diff-tree[1]::
        Compares the content and mode of blobs found via two tree objects.
 
+gitlink:git-for-each-ref[1]::
+       Output information on each ref.
+
 gitlink:git-fsck-objects[1]::
        Verifies the connectivity and validity of the objects in the database.