Autogenerated HTML docs for v1.5.4-rc0
authorJunio C Hamano <junio@hera.kernel.org>
Thu, 13 Dec 2007 02:45:30 +0000 (02:45 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Thu, 13 Dec 2007 02:45:30 +0000 (02:45 +0000)
RelNotes-1.5.4.txt
git-help.html
git-help.txt
git-instaweb.html
git-instaweb.txt
git-shortlog.html
git-shortlog.txt
git.html
git.txt

index 7386e66dc9f80eb7a9cafba3f637f04eaef21e14..6645565c5282c85a168aeff0e7fb16664d9120c5 100644 (file)
@@ -246,12 +246,27 @@ Updates since v1.5.3
    descriptive name from From: and Signed-off-by: lines in the commit
    message.
 
+ * "git svn" wasted way too much disk to record revision mappings
+   between svn and git; a new representation that is much more compact
+   for this information has been introduced to correct this.
+
  * "git status" from a subdirectory now shows relative paths, which
    makes copy-and-pasting for git-checkout/git-add/git-rm easier.  The
    traditional behaviour to show the full path relative to the top of
    the work tree can be had by setting status.relativepaths
    configuration variable to true.
 
+ * "git blame" kept text for each annotated revision in core needlessly;
+   this has been corrected.
+
+ * "git shortlog" learned to default to HEAD when the standard input is
+   a terminal and the user did not give any revision parameter.
+
+ * "git shortlog" learned "-e" option to show e-mail addresses as well as
+   authors' names.
+
+ * "git help" learned "-w" option to show documentation in browsers.
+
  * In addition there are quite a few internal clean-ups. Notably
 
    - many fork/exec have been replaced with run-command API,
@@ -279,6 +294,6 @@ series.
 
 --
 exec >/var/tmp/1
-O=v1.5.3.7-1148-gcf7e147
+O=v1.5.4-rc0
 echo O=`git describe refs/heads/master`
 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint
index 629264490b0e091b9e812132c6c7cd05c13ce50e..b58cd0deb96f03b5608c3ab599191071ea7e5b76 100644 (file)
@@ -272,7 +272,7 @@ git-help(1) Manual Page
 </div>\r
 <h2>SYNOPSIS</h2>\r
 <div class="sectionbody">\r
-<p><em>git help</em> [-a|--all] [COMMAND]</p>\r
+<p><em>git help</em> [-a|--all|-i|--info|-w|--web] [COMMAND]</p>\r
 </div>\r
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
@@ -282,7 +282,8 @@ on the standard output.</p>
 <p>If the option <em>--all</em> or <em>-a</em> is given, then all available commands are\r
 printed on the standard output.</p>\r
 <p>If a git command is named, a manual page for that command is brought\r
-up. The <em>man</em> program is used by default for this purpose.</p>\r
+up. The <em>man</em> program is used by default for this purpose, but this\r
+can be overriden by other options.</p>\r
 <p>Note that <em>git --help &#8230;</em> is identical as <em>git help &#8230;</em> because the\r
 former is internally converted into the latter.</p>\r
 </div>\r
@@ -298,6 +299,35 @@ former is internally converted into the latter.</p>
         option superseeds any other option.\r
 </p>\r
 </dd>\r
+<dt>\r
+-i|--info\r
+</dt>\r
+<dd>\r
+<p>\r
+        Use the <em>info</em> program to display the manual page, instead of\r
+        the <em>man</em> program that is used by default.\r
+</p>\r
+</dd>\r
+<dt>\r
+-w|--web\r
+</dt>\r
+<dd>\r
+<p>\r
+        Use a web browser to display the HTML manual page, instead of\r
+        the <em>man</em> program that is used by default.\r
+</p>\r
+<p>The web browser can be specified using the configuration variable\r
+<em>help.browser</em>, or <em>web.browser</em> if the former is not set. If none of\r
+these config variables is set, the <em>git-browse-help</em> script (called by\r
+<em>git-help</em>) will pick a suitable default.</p>\r
+<p>You can explicitly provide a full path to your prefered browser by\r
+setting the configuration variable <em>browser.&lt;tool&gt;.path</em>. For example,\r
+you can configure the absolute path to firefox by setting\r
+<em>browser.firefox.path</em>. Otherwise, <em>git-browse-help</em> assumes the tool\r
+is available in PATH.</p>\r
+<p>Note that the script tries, as much as possible, to display the HTML\r
+page in a new tab on an already opened browser.</p>\r
+</dd>\r
 </dl>\r
 </div>\r
 <h2>Author</h2>\r
@@ -317,7 +347,7 @@ little. Maintenance is done by the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 04-Dec-2007 08:29:49 UTC\r
+Last updated 13-Dec-2007 02:42:55 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 7ddbf467dfdf1d5a7825836d951cd54b336265b0..ac9e15d7748a17bdd552acfb0c690ffea459a87c 100644 (file)
@@ -7,7 +7,7 @@ git-help - display help information about git
 
 SYNOPSIS
 --------
-'git help' [-a|--all] [COMMAND]
+'git help' [-a|--all|-i|--info|-w|--web] [COMMAND]
 
 DESCRIPTION
 -----------
@@ -20,7 +20,8 @@ If the option '--all' or '-a' is given, then all available commands are
 printed on the standard output.
 
 If a git command is named, a manual page for that command is brought
-up. The 'man' program is used by default for this purpose.
+up. The 'man' program is used by default for this purpose, but this
+can be overriden by other options.
 
 Note that 'git --help ...' is identical as 'git help ...' because the
 former is internally converted into the latter.
@@ -28,10 +29,31 @@ former is internally converted into the latter.
 OPTIONS
 -------
 -a|--all::
-
        Prints all the available commands on the standard output. This
        option superseeds any other option.
 
+-i|--info::
+       Use the 'info' program to display the manual page, instead of
+       the 'man' program that is used by default.
+
+-w|--web::
+       Use a web browser to display the HTML manual page, instead of
+       the 'man' program that is used by default.
++
+The web browser can be specified using the configuration variable
+'help.browser', or 'web.browser' if the former is not set. If none of
+these config variables is set, the 'git-browse-help' script (called by
+'git-help') will pick a suitable default.
++
+You can explicitly provide a full path to your prefered browser by
+setting the configuration variable 'browser.<tool>.path'. For example,
+you can configure the absolute path to firefox by setting
+'browser.firefox.path'. Otherwise, 'git-browse-help' assumes the tool
+is available in PATH.
++
+Note that the script tries, as much as possible, to display the HTML
+page in a new tab on an already opened browser.
+
 Author
 ------
 Written by Junio C Hamano <gitster@pobox.com> and the git-list
index 21b6cdc711dd6a6201f18dd122f8b28c99a40c99..9531a109a8129dbc1edc1f7f286e0da2289898d8 100644 (file)
@@ -375,6 +375,8 @@ repository.</p>
         modulepath = /usr/lib/apache2/modules\r
 </tt></pre>\r
 </div></div>\r
+<p>If the configuration variable <em>instaweb.browser</em> is not set,\r
+<em>web.browser</em> will be used instead if it is defined.</p>\r
 </div>\r
 <h2>Author</h2>\r
 <div class="sectionbody">\r
@@ -390,7 +392,7 @@ repository.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 14-Nov-2007 12:11:34 UTC\r
+Last updated 13-Dec-2007 02:42:55 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 735008c1ab172cda93e6f98b75b401c37f1cd22f..d2ce7790e61126d1f3256dfc207311a0d6d27e56 100644 (file)
@@ -71,6 +71,9 @@ You may specify configuration in your .git/config
 
 -----------------------------------------------------------------------
 
+If the configuration variable 'instaweb.browser' is not set,
+'web.browser' will be used instead if it is defined.
+
 Author
 ------
 Written by Eric Wong <normalperson@yhbt.net>
index 1520e34a27c77d89d37117ca42addeb20e05c7be..cff79738f98110a1db1511c8c3195ff85fe349ca 100644 (file)
@@ -273,8 +273,8 @@ git-shortlog(1) Manual Page
 <h2>SYNOPSIS</h2>\r
 <div class="sectionbody">\r
 <div class="verseblock">\r
-<div class="content">git-log --pretty=short | <em>git-shortlog</em> [-h] [-n] [-s]\r
-git-shortlog [-n|--numbered] [-s|--summary] [&lt;committish&gt;&#8230;]</div></div>\r
+<div class="content">git-log --pretty=short | <em>git-shortlog</em> [-h] [-n] [-s] [-e]\r
+git-shortlog [-n|--numbered] [-s|--summary] [-e|--email] [&lt;committish&gt;&#8230;]</div></div>\r
 </div>\r
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
@@ -311,6 +311,14 @@ the first line of the commit message will be shown.</p>
         Suppress commit description and provide a commit count summary only.\r
 </p>\r
 </dd>\r
+<dt>\r
+-e, --email\r
+</dt>\r
+<dd>\r
+<p>\r
+        Show the email address of each author.\r
+</p>\r
+</dd>\r
 </dl>\r
 </div>\r
 <h2>FILES</h2>\r
@@ -344,7 +352,7 @@ Eve Jones &lt;eve@laptop.(none)&gt;</tt></pre>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 14-Nov-2007 12:11:48 UTC\r
+Last updated 13-Dec-2007 02:42:55 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 2220ef6ea8d3bfa58f3c1279dfcf4f735c2dae0a..e14720b73ff6b44d0300e9a8ad0fbd781738440d 100644 (file)
@@ -8,8 +8,8 @@ git-shortlog - Summarize 'git log' output
 SYNOPSIS
 --------
 [verse]
-git-log --pretty=short | 'git-shortlog' [-h] [-n] [-s]
-git-shortlog [-n|--numbered] [-s|--summary] [<committish>...]
+git-log --pretty=short | 'git-shortlog' [-h] [-n] [-s] [-e]
+git-shortlog [-n|--numbered] [-s|--summary] [-e|--email] [<committish>...]
 
 DESCRIPTION
 -----------
@@ -32,6 +32,9 @@ OPTIONS
 -s, \--summary::
        Suppress commit description and provide a commit count summary only.
 
+-e, \--email::
+       Show the email address of each author.
+
 FILES
 -----
 
index 0a13e42d5208cda68429c685daf71e22348880af..98342c845b1a2a0e707996297968a62b66c902da 100644 (file)
--- a/git.html
+++ b/git.html
@@ -316,6 +316,10 @@ documentation can be viewed at
         available commands are printed. If a git command is named this\r
         option will bring up the manual page for that command.\r
 </p>\r
+<p>Other options are available to control how the manual page is\r
+displayed. See <a href="git-help.html">git-help(1)</a> for more information,\r
+because <em>git --help &#8230;</em> is converted internally into <em>git\r
+help &#8230;</em>.</p>\r
 </dd>\r
 <dt>\r
 --exec-path\r
@@ -1941,7 +1945,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 05-Dec-2007 10:59:15 UTC\r
+Last updated 13-Dec-2007 02:42:55 UTC\r
 </div>\r
 </div>\r
 </body>\r
diff --git a/git.txt b/git.txt
index 1574ecd77eccc586c62b745465bffb80baf67ce7..a29b634e7a8d86a3e03f7d90ca81a9e86b068730 100644 (file)
--- a/git.txt
+++ b/git.txt
@@ -104,6 +104,11 @@ OPTIONS
        commands. If the option '--all' or '-a' is given then all
        available commands are printed. If a git command is named this
        option will bring up the manual page for that command.
++
+Other options are available to control how the manual page is
+displayed. See gitlink:git-help[1] for more information,
+because 'git --help ...' is converted internally into 'git
+help ...'.
 
 --exec-path::
        Path to wherever your core git programs are installed.