Autogenerated HTML docs for v1.5.2.2-619-g06f59

diff --git a/RelNotes-1.5.3.txt b/RelNotes-1.5.3.txt
index d111661a7b1fe8f5089d59cfc2b88ae7305b1eef..ef2f95b3c5f7803f1ae93d454d13e19730201e48 100644 (file)
--- a/RelNotes-1.5.3.txt
+++ b/RelNotes-1.5.3.txt
@@ -1,4 +1,4 @@
-GIT v1.5.3 Release Notes (draft)
+GIT v1.5.3 Release Notes
 ========================
 
 Updates since v1.5.2
@@ -10,8 +10,23 @@ Updates since v1.5.2
 * Thee are a handful pack-objects changes to help you cope better with
   repositories with pathologically large blobs in them.
 
+* For people who need to import from Perforce, a front-end for
+  fast-import is in contrib/fast-import/ now.
+
+* Comes with git-gui 0.8.0.
+
+* Comes with updated gitk.
+
 * New commands and options.
 
+  - "git log" learned a new option '--follow', to follow
+    renaming history of a single file.
+
+  - "git-filter-branch" is a reborn cg-admin-rewritehist.
+
+  - "git-cvsserver" learned new options (--base-path, --export-all,
+    --strict-paths) inspired by git-daemon.
+
   - "git-submodule" command helps you manage the projects from
     the superproject that contain them.
 
@@ -36,9 +51,45 @@ Updates since v1.5.2
   - "git repack" can be told to split resulting packs to avoid
     exceeding limit specified with "--max-pack-size".
 
+  - "git fsck" gained --verbose option.  This is really really
+    verbose but it might help you identify exact commit that is
+    corrupt in your repository.
+
+  - "git format-patch" learned --numbered-files option.  This
+    may be useful for MH users.
+
+  - "git tag -n -l" shows tag annotations while listing tags.
+
+  - "git cvsimport" can optionally use the separate-remote layout.
+
+  - "git blame" can be told to see through commits that changes
+    whitespaces and indentation levels with "-w" option.
+
+  - "git send-email" can be told not to thread the messages when
+    sending out more than one patches.
+
+  - "git config" learned NUL terminated output format via -z to
+    help scripts.
+
 * Updated behavior of existing commands.
 
-  - "git push" pretends that you immediately fetched back from
+  - "git mergetool" chooses its backend more wisely, taking
+    notice of its environment such as use of X, Gnome/KDE, etc.
+
+  - "gitweb" shows merge commits a lot nicer than before.  The
+    default view uses more compact --cc format, while the UI
+    allows to choose normal diff with any parent.
+
+  - snapshot files "gitweb" creates from a repository at
+    $path/$project/.git are more useful.  We use $project part
+    in the filename, which we used to discard.
+
+  - "git cvsimort" creates lightweight tag; there is not any
+    interesting information we can record in an annotated tag,
+    and the handcrafted ones the old code created was not
+    properly formed anyway.
+
+  - "git-push" pretends that you immediately fetched back from
     the remote by updating corresponding remote tracking
     branches if you have any.
 
@@ -48,17 +99,25 @@ Updates since v1.5.2
   - "git-apply --whitespace=strip" removes blank lines added at
     the end of the file.
 
-  - fetch over git native protocols with -v shows connection
+  - "git-fetch" over git native protocols with -v shows connection
     status, and the IP address of the other end, to help
     diagnosing problems.
 
-  - core.legacyheaders is no more, although we still can read
-    objects created in a new loose object format.
+  - We used to have core.legacyheaders configuration, when
+    set to false, allowed git to write loose objects in a format
+    that mimicks the format used by objects stored in packs.  It
+    turns out that this was not so useful.  Although we will
+    continue to read objects written in that format, we do not
+    honor that configuration anymore and create loose objects in
+    the legacy/traditional format.
+
+  - "--find-copies-harder" option to diff family can now be
+    spelled as "-C -C" for brevity.
 
   - "git-mailsplit" (hence "git-am") can read from Maildir
     formatted mailboxes.
 
-  - "git cvsserver" does not barf upon seeing "cvs login"
+  - "git-cvsserver" does not barf upon seeing "cvs login"
     request.
 
   - "pack-objects" honors "delta" attribute set in
@@ -68,10 +127,25 @@ Updates since v1.5.2
   - new-workdir script (in contrib) can now be used with a bare
     repository.
 
+  - "git-mergetool" learned to use gvimdiff.
+
+  - "gitview" (in contrib) has a better blame interface.
+
+  - "git log" and friends did not handle a commit log message
+    that is larger than 16kB; they do now.
+
+  - "--pretty=oneline" output format for "git log" and friends
+    deals with "malformed" commit log messages that have more
+    than one lines in the first paragraph better.  We used to
+    show the first line, cutting the title at mid-sentence; we
+    concatenate them into a single line and treat the result as
+    "oneline".
 
 * Builds
 
-  -
+  - old-style function definitions (most notably, a function
+    without parameter defined with "func()", not "func(void)")
+    have been eradicated.
 
 * Performance Tweaks
 
@@ -88,6 +162,10 @@ Updates since v1.5.2
     the object requested the last time, which exploits the
     locality of references.
 
+  - verifying pack contents done by "git fsck --full" got boost
+    by carefully choosing the order to verify objects in them.
+
+
 Fixes since v1.5.2
 ------------------
 
@@ -96,14 +174,11 @@ this release, unless otherwise noted.
 
 * Bugfixes
 
-  - ....  This has not
-    been backported to 1.5.2.x series, as it is rather an
-    intrusive change.
-
+  - "gitweb" had trouble handling non UTF-8 text with older
+    Encode.pm Perl module.
 
 --
 exec >/var/tmp/1
-O=v1.5.2-45-ged82edc
-O=v1.5.2-172-g1a8b769
+O=v1.5.2.2-603-g7c85173
 echo O=`git describe refs/heads/master`
 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint

diff --git a/git-remote.html b/git-remote.html
index dffebf8b9108840f6bcb950672a92d024c2e5bcf..22b01ddc52a370de4bda95624a9c9f67da729a22 100644 (file)
--- a/git-remote.html
+++ b/git-remote.html
@@ -315,6 +315,8 @@ branch the <tt>HEAD</tt> at the remote repository actually points at.</p>
 <p>\r
 Gives some information about the remote &lt;name&gt;.\r
 </p>\r
+<p>With <tt>-n</tt> option, the remote heads are not queried first with\r
+<tt>git ls-remote &lt;name&gt;</tt>; cached information is used instead.</p>\r
 </dd>\r
 <dt>\r
 <em>prune</em>\r
@@ -326,6 +328,9 @@ These stale branches have already been removed from the remote repository
 referenced by &lt;name&gt;, but are still locally available in\r
 "remotes/&lt;name&gt;".\r
 </p>\r
+<p>With <tt>-n</tt> option, the remote heads are not confirmed first with <tt>git\r
+ls-remote &lt;name&gt;</tt>; cached information is used instead.  Use with\r
+caution.</p>\r
 </dd>\r
 <dt>\r
 <em>update</em>\r
@@ -410,7 +415,7 @@ $ git merge origin</tt></pre>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 16-Jun-2007 09:49:18 UTC\r
+Last updated 01-Jul-2007 06:34:00 UTC\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/git-remote.txt b/git-remote.txt
index ab232c2f68e1c4bf47977ea3be4fc2ae525fb67b..61a6022ce8a0fc7aac8b1e9bd08587817ef0d69c 100644 (file)
--- a/git-remote.txt
+++ b/git-remote.txt
@@ -49,6 +49,9 @@ branch the `HEAD` at the remote repository actually points at.
 'show'::
 
 Gives some information about the remote <name>.
++
+With `-n` option, the remote heads are not queried first with
+`git ls-remote <name>`; cached information is used instead.
 
 'prune'::
 
@@ -56,6 +59,10 @@ Deletes all stale tracking branches under <name>.
 These stale branches have already been removed from the remote repository
 referenced by <name>, but are still locally available in
 "remotes/<name>".
++
+With `-n` option, the remote heads are not confirmed first with `git
+ls-remote <name>`; cached information is used instead.  Use with
+caution.
 
 'update'::
 

diff --git a/git-repack.html b/git-repack.html
index 616d35764fd6bfdfb38bacf90417546a4a855afb..b88acd511c8af97fb2da0205387e01bf3fbee41d 100644 (file)
--- a/git-repack.html
+++ b/git-repack.html
@@ -277,7 +277,8 @@ git-repack(1) Manual Page
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
 <p>This script is used to combine all objects that do not currently\r
-reside in a "pack", into a pack.</p>\r
+reside in a "pack", into a pack.  It can also be used to re-organise\r
+existing packs into a single, more efficient pack.</p>\r
 <p>A pack is a collection of objects, individually compressed, with\r
 delta compression applied, stored in a single file, with an\r
 associated index file.</p>\r
@@ -293,11 +294,13 @@ engines, disk storage, etc.</p>
 <dd>\r
 <p>\r
         Instead of incrementally packing the unpacked objects,\r
-        pack everything available into a single pack.\r
+        pack everything referenced into a single pack.\r
         Especially useful when packing a repository that is used\r
         for private development and there is no need to worry\r
-        about people fetching via dumb file transfer protocols\r
-        from it.  Use with <em>-d</em>.\r
+        about people fetching via dumb protocols from it.  Use\r
+        with <em>-d</em>.  This will clean up the objects that <tt>git prune</tt>\r
+        leaves behind, but <tt>git fsck --full</tt> shows as\r
+        dangling.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -404,7 +407,7 @@ that way can try to use older git with it).</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 16-Jun-2007 09:49:18 UTC\r
+Last updated 01-Jul-2007 06:34:00 UTC\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/git-repack.txt b/git-repack.txt
index c33a512ffb0bfaef8c920ecff7c2630d2eabf0b9..28949397ca7434471f1e9c1552ecae1ade9b8313 100644 (file)
--- a/git-repack.txt
+++ b/git-repack.txt
@@ -14,7 +14,8 @@ DESCRIPTION
 -----------
 
 This script is used to combine all objects that do not currently
-reside in a "pack", into a pack.
+reside in a "pack", into a pack.  It can also be used to re-organise
+existing packs into a single, more efficient pack.
 
 A pack is a collection of objects, individually compressed, with
 delta compression applied, stored in a single file, with an
@@ -28,11 +29,13 @@ OPTIONS
 
 -a::
        Instead of incrementally packing the unpacked objects,
-       pack everything available into a single pack.
+       pack everything referenced into a single pack.
        Especially useful when packing a repository that is used
        for private development and there is no need to worry
-       about people fetching via dumb file transfer protocols
-       from it.  Use with '-d'.
+       about people fetching via dumb protocols from it.  Use
+       with '-d'.  This will clean up the objects that `git prune`
+       leaves behind, but `git fsck --full` shows as
+       dangling.
 
 -d::
        After packing, if the newly created packs make some

diff --git a/git.html b/git.html
index 39195d30ca674faa0a81f2c94f6883a395ad49e0..bf8707c45ed49217e89be855b856cae5e5a363e5 100644 (file)
--- a/git.html
+++ b/git.html
@@ -1765,6 +1765,21 @@ parameter, &lt;path&gt;.</p>
 </p>\r
 </dd>\r
 <dt>\r
+<em>GIT_FLUSH</em>\r
+</dt>\r
+<dd>\r
+<p>\r
+        If this environment variable is set to "1", then commands such\r
+        as git-blame (in incremental mode), git-rev-list, git-log,\r
+        git-whatchanged, etc., will force a flush of the output stream\r
+        after each commit-oriented record have been flushed.   If this\r
+        variable is set to "0", the output of these commands will be done\r
+        using completely buffered I/O.   If this environment variable is\r
+        not set, git will choose buffered or record-oriented flushing\r
+        based on whether stdout appears to be redirected to a file or not.\r
+</p>\r
+</dd>\r
+<dt>\r
 <em>GIT_TRACE</em>\r
 </dt>\r
 <dd>\r
@@ -2341,7 +2356,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 23-Jun-2007 08:48:31 UTC\r
+Last updated 01-Jul-2007 06:34:01 UTC\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/git.txt b/git.txt
index 20b5b7bb48f75cea066857c6967a08203957d927..826914837bc0a3e1fa5f044f69b837abdd42cf8c 100644 (file)
--- a/git.txt
+++ b/git.txt
@@ -396,6 +396,16 @@ other
 'GIT_PAGER'::
        This environment variable overrides `$PAGER`.
 
+'GIT_FLUSH'::
+       If this environment variable is set to "1", then commands such
+       as git-blame (in incremental mode), git-rev-list, git-log,
+       git-whatchanged, etc., will force a flush of the output stream
+       after each commit-oriented record have been flushed.   If this
+       variable is set to "0", the output of these commands will be done
+       using completely buffered I/O.   If this environment variable is
+       not set, git will choose buffered or record-oriented flushing
+       based on whether stdout appears to be redirected to a file or not.
+
 'GIT_TRACE'::
        If this variable is set to "1", "2" or "true" (comparison
        is case insensitive), git will print `trace:` messages on