Autogenerated HTML docs for v1.5.0-rc2-61-g1b60
authorJunio C Hamano <junio@hera.kernel.org>
Sun, 28 Jan 2007 10:29:21 +0000 (10:29 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Sun, 28 Jan 2007 10:29:21 +0000 (10:29 +0000)
13 files changed:
config.txt
diff-options.txt
git-describe.html
git-describe.txt
git-diff-files.html
git-diff-index.html
git-diff-stages.html
git-diff-tree.html
git-diff.html
git-repo-config.html
git-tag.html
git-tag.txt
git.html

index 3f2fa09a87b0cbfb517591ff0472b1ff5cd81ef8..6ea7c76a6af24139b8de1553b6204f32939acd53 100644 (file)
@@ -469,6 +469,13 @@ user.name::
        Can be overridden by the 'GIT_AUTHOR_NAME' and 'GIT_COMMITTER_NAME'
        environment variables.  See gitlink:git-commit-tree[1].
 
+user.signingkey::
+       If gitlink:git-tag[1] is not selecting the key you want it to
+       automatically when creating a signed tag, you can override the
+       default selection with this variable.  This option is passed
+       unchanged to gpg's --local-user parameter, so you may specify a key
+       using any method that gpg supports.
+
 whatchanged.difftree::
        The default gitlink:git-diff-tree[1] arguments to be used
        for gitlink:git-whatchanged[1].
index da1cc60e970027bec50c484e1db5717ec90eb150..019a39f2bf7253f3938d87a21a5467e37e33a2e0 100644 (file)
        Turn off rename detection, even when the configuration
        file gives the default to do so.
 
+--check::
+       Warn if changes introduce trailing whitespace
+       or an indent that uses a space before a tab.
+
 --full-index::
        Instead of the first handful characters, show full
        object name of pre- and post-image blob on the "index"
index 536fbbbe6b3d9fe0b06995007f144f592fb76c04..3ea1ff5086d7c3def857d4ba05e7f9ada8149340 100644 (file)
@@ -278,8 +278,8 @@ git-describe(1) Manual Page
 <div class="sectionbody">\r
 <p>The command finds the most recent tag that is reachable from a\r
 commit, and if the commit itself is pointed at by the tag, shows\r
-the tag.  Otherwise, it suffixes the tag name with abbreviated\r
-object name of the commit.</p>\r
+the tag.  Otherwise, it suffixes the tag name with the number of\r
+additional commits and the abbreviated object name of the commit.</p>\r
 </div>\r
 <h2>OPTIONS</h2>\r
 <div class="sectionbody">\r
@@ -348,12 +348,17 @@ object name of the commit.</p>
 <div class="literalblock">\r
 <div class="content">\r
 <pre><tt>[torvalds@g5 git]$ git-describe parent\r
-v1.0.4-g2414721b</tt></pre>\r
+v1.0.4-14-g2414721</tt></pre>\r
 </div></div>\r
 <p>i.e. the current head of my "parent" branch is based on v1.0.4,\r
-but since it has a few commits on top of that, it has added the\r
-git hash of the thing to the end: "-g" + 8-char shorthand for\r
-the commit <tt>2414721b194453f058079d897d13c4e377f92dc6</tt>.</p>\r
+but since it has a handful commits on top of that,\r
+describe has added the number of additional commits ("14") and\r
+an abbreviated object name for the commit itself ("2414721")\r
+at the end.</p>\r
+<p>The number of additional commits is the number\r
+of commits which would be displayed by "git log v1.0.4..parent".\r
+The hash suffix is "-g" + 7-char abbreviation for the tip commit\r
+of parent (which was <tt>2414721b194453f058079d897d13c4e377f92dc6</tt>).</p>\r
 <p>Doing a "git-describe" on a tag-name will just show the tag name:</p>\r
 <div class="literalblock">\r
 <div class="content">\r
@@ -365,12 +370,19 @@ the output shows the reference path as well:</p>
 <div class="literalblock">\r
 <div class="content">\r
 <pre><tt>[torvalds@g5 git]$ git describe --all --abbrev=4 v1.0.5^2\r
-tags/v1.0.0-g975b</tt></pre>\r
+tags/v1.0.0-21-g975b</tt></pre>\r
 </div></div>\r
 <div class="literalblock">\r
 <div class="content">\r
 <pre><tt>[torvalds@g5 git]$ git describe --all HEAD^\r
-heads/lt/describe-g975b</tt></pre>\r
+heads/lt/describe-7-g975b</tt></pre>\r
+</div></div>\r
+<p>With --abbrev set to 0, the command can be used to find the\r
+closest tagname without any suffix:</p>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>[torvalds@g5 git]$ git describe --abbrev=0 v1.0.5^2\r
+tags/v1.0.0</tt></pre>\r
 </div></div>\r
 </div>\r
 <h2>SEARCH STRATEGY</h2>\r
@@ -393,7 +405,8 @@ will be the smallest number of commits possible.</p>
 <h2>Author</h2>\r
 <div class="sectionbody">\r
 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;, but somewhat\r
-butchered by Junio C Hamano &lt;junkio@cox.net&gt;</p>\r
+butchered by Junio C Hamano &lt;junkio@cox.net&gt;.  Later significantly\r
+updated by Shawn Pearce &lt;spearce@spearce.org&gt;.</p>\r
 </div>\r
 <h2>Documentation</h2>\r
 <div class="sectionbody">\r
@@ -405,7 +418,7 @@ butchered by Junio C Hamano &lt;junkio@cox.net&gt;</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 15-Jan-2007 06:12:30 UTC\r
+Last updated 28-Jan-2007 10:29:05 UTC\r
 </div>\r
 </div>\r
 </body>\r
index b87783cf0956bba11ef0101a9ac80fe1f91e3f80..47a583d3a605d95fb860e6ea7142cebf374ec5aa 100644 (file)
@@ -14,8 +14,8 @@ DESCRIPTION
 -----------
 The command finds the most recent tag that is reachable from a
 commit, and if the commit itself is pointed at by the tag, shows
-the tag.  Otherwise, it suffixes the tag name with abbreviated
-object name of the commit.
+the tag.  Otherwise, it suffixes the tag name with the number of
+additional commits and the abbreviated object name of the commit.
 
 
 OPTIONS
@@ -52,12 +52,18 @@ EXAMPLES
 With something like git.git current tree, I get:
 
        [torvalds@g5 git]$ git-describe parent
-       v1.0.4-g2414721b
+       v1.0.4-14-g2414721
 
 i.e. the current head of my "parent" branch is based on v1.0.4,
-but since it has a few commits on top of that, it has added the
-git hash of the thing to the end: "-g" + 8-char shorthand for
-the commit `2414721b194453f058079d897d13c4e377f92dc6`.
+but since it has a handful commits on top of that,
+describe has added the number of additional commits ("14") and
+an abbreviated object name for the commit itself ("2414721")
+at the end.
+
+The number of additional commits is the number
+of commits which would be displayed by "git log v1.0.4..parent".
+The hash suffix is "-g" + 7-char abbreviation for the tip commit
+of parent (which was `2414721b194453f058079d897d13c4e377f92dc6`).
 
 Doing a "git-describe" on a tag-name will just show the tag name:
 
@@ -68,10 +74,16 @@ With --all, the command can use branch heads as references, so
 the output shows the reference path as well:
 
        [torvalds@g5 git]$ git describe --all --abbrev=4 v1.0.5^2
-       tags/v1.0.0-g975b
+       tags/v1.0.0-21-g975b
 
        [torvalds@g5 git]$ git describe --all HEAD^
-       heads/lt/describe-g975b
+       heads/lt/describe-7-g975b
+
+With --abbrev set to 0, the command can be used to find the
+closest tagname without any suffix:
+
+       [torvalds@g5 git]$ git describe --abbrev=0 v1.0.5^2
+       tags/v1.0.0
 
 SEARCH STRATEGY
 ---------------
@@ -97,7 +109,8 @@ will be the smallest number of commits possible.
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>, but somewhat
-butchered by Junio C Hamano <junkio@cox.net>
+butchered by Junio C Hamano <junkio@cox.net>.  Later significantly
+updated by Shawn Pearce <spearce@spearce.org>.
 
 Documentation
 --------------
index a755740bb4f15982c5ff6284c982b1dfee555cbe..ea184a542cc6513ef0df298805a760fc04ac9b13 100644 (file)
@@ -425,6 +425,15 @@ same as "git-diff-index" and "git-diff-tree".</p>
 </p>\r
 </dd>\r
 <dt>\r
+--check\r
+</dt>\r
+<dd>\r
+<p>\r
+        Warn if changes introduce trailing whitespace\r
+        or an indent that uses a space before a tab.\r
+</p>\r
+</dd>\r
+<dt>\r
 --full-index\r
 </dt>\r
 <dd>\r
@@ -986,7 +995,7 @@ two unresolved merge parents with the working tree file
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 26-Dec-2006 09:11:30 UTC\r
+Last updated 28-Jan-2007 10:29:05 UTC\r
 </div>\r
 </div>\r
 </body>\r
index ec23f3d789ef46335d382f65050351d0d2b664af..a0d25fb4464732c3af17f9b67221c95099a6408f 100644 (file)
@@ -426,6 +426,15 @@ entries in the index are compared.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--check\r
+</dt>\r
+<dd>\r
+<p>\r
+        Warn if changes introduce trailing whitespace\r
+        or an indent that uses a space before a tab.\r
+</p>\r
+</dd>\r
+<dt>\r
 --full-index\r
 </dt>\r
 <dd>\r
@@ -1076,7 +1085,7 @@ always have the special all-zero sha1.</td>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 26-Dec-2006 09:11:31 UTC\r
+Last updated 28-Jan-2007 10:29:06 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 1cefce3913e871767bdba730b1c721b23ae4385a..8fc33a4f7bd412440861380d84727bd12c89bfdb 100644 (file)
@@ -423,6 +423,15 @@ unmerged index file.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--check\r
+</dt>\r
+<dd>\r
+<p>\r
+        Warn if changes introduce trailing whitespace\r
+        or an indent that uses a space before a tab.\r
+</p>\r
+</dd>\r
+<dt>\r
 --full-index\r
 </dt>\r
 <dd>\r
@@ -960,7 +969,7 @@ two unresolved merge parents with the working tree file
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 19-Jan-2007 00:37:17 UTC\r
+Last updated 28-Jan-2007 10:29:07 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 61e5b019fe41b23487e6eefa948b99c8c332cb7a..89f31391176466d26ed7786e8b2accea9f6d8599 100644 (file)
@@ -428,6 +428,15 @@ git-diff-tree(1) Manual Page
 </p>\r
 </dd>\r
 <dt>\r
+--check\r
+</dt>\r
+<dd>\r
+<p>\r
+        Warn if changes introduce trailing whitespace\r
+        or an indent that uses a space before a tab.\r
+</p>\r
+</dd>\r
+<dt>\r
 --full-index\r
 </dt>\r
 <dd>\r
@@ -1280,7 +1289,7 @@ two unresolved merge parents with the working tree file
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 31-Dec-2006 01:19:02 UTC\r
+Last updated 28-Jan-2007 10:29:07 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 899b6e271461fd93643b8fcdbcf08e4508d51e1d..8374fdb261e73a12ef80fc7949daab1adc15d617 100644 (file)
@@ -474,6 +474,15 @@ any &lt;tree-ish&gt;.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--check\r
+</dt>\r
+<dd>\r
+<p>\r
+        Warn if changes introduce trailing whitespace\r
+        or an indent that uses a space before a tab.\r
+</p>\r
+</dd>\r
+<dt>\r
 --full-index\r
 </dt>\r
 <dd>\r
@@ -819,7 +828,7 @@ output diff in reverse.
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 18-Jan-2007 06:23:58 UTC\r
+Last updated 28-Jan-2007 10:29:09 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 097a0a2991ac4406ee00a547a4efb561165ffb68..07a6b512251881ab75f158c5f4c952602e1b02fe 100644 (file)
@@ -1311,6 +1311,18 @@ user.name
 </p>\r
 </dd>\r
 <dt>\r
+user.signingkey\r
+</dt>\r
+<dd>\r
+<p>\r
+        If <a href="git-tag.html">git-tag(1)</a> is not selecting the key you want it to\r
+        automatically when creating a signed tag, you can override the\r
+        default selection with this variable.  This option is passed\r
+        unchanged to gpg's --local-user parameter, so you may specify a key\r
+        using any method that gpg supports.\r
+</p>\r
+</dd>\r
+<dt>\r
 whatchanged.difftree\r
 </dt>\r
 <dd>\r
@@ -1378,7 +1390,7 @@ transfer.unpackLimit
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 25-Jan-2007 07:59:39 UTC\r
+Last updated 28-Jan-2007 10:29:09 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 727ec47ceb2e5fc37cfdb37d8ad104980e0b3af5..d3609a826f657882aa7937ec23dd1c10bf502043 100644 (file)
@@ -375,6 +375,17 @@ if no pattern is given).</p>
 </dd>\r
 </dl>\r
 </div>\r
+<h2>CONFIGURATION</h2>\r
+<div class="sectionbody">\r
+<p>By default, git-tag in sign-with-default mode (-s) will use your\r
+committer identity (of the form "Your Name &lt;your@email.address&gt;") to\r
+find a key.  If you want to use a different default key, you can specify\r
+it in the repository configuration as follows:</p>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>signingkey = &lt;gpg-key-id&gt;</tt></pre>\r
+</div></div>\r
+</div>\r
 <h2>Author</h2>\r
 <div class="sectionbody">\r
 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;,\r
@@ -390,7 +401,7 @@ Junio C Hamano &lt;junkio@cox.net&gt; and Chris Wright &lt;chrisw@osdl.org&gt;.<
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 21-Jan-2007 08:57:04 UTC\r
+Last updated 28-Jan-2007 10:29:11 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 13c7aefbf332124c5282a9a8532c7c9f8e0564f1..3f01e0bfc5eb72bfbd8c3ab97e4b9ac495463edb 100644 (file)
@@ -70,6 +70,16 @@ OPTIONS
        Take the tag message from the given file.  Use '-' to
        read the message from the standard input.
 
+CONFIGURATION
+-------------
+By default, git-tag in sign-with-default mode (-s) will use your
+committer identity (of the form "Your Name <your@email.address>") to
+find a key.  If you want to use a different default key, you can specify
+it in the repository configuration as follows:
+
+[user]
+    signingkey = <gpg-key-id>
+
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>,
index 76c121c43e50a3223e005ae89a589c6b53416d1b..e1910cdb222fabff0966b8de45c703efdc47d9cb 100644 (file)
--- a/git.html
+++ b/git.html
@@ -2285,7 +2285,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 26-Jan-2007 09:44:41 UTC\r
+Last updated 28-Jan-2007 10:29:11 UTC\r
 </div>\r
 </div>\r
 </body>\r