Autogenerated HTML docs for v2.8.0-rc3

RelNotes/2.8.0.txt

@@ -16,7 +16,9 @@ UI, Workflows & Features
    the source repository has packed references for a long time, and
    nobody noticed nor complained about it.
 
- * "branch --delete" has "branch -d" but "push --delete" does not.
+ * "push" learned that its "--delete" option can be shortened to
+   "-d", just like "branch --delete" and "branch -d" are the same
+   thing.
 
  * "git blame" learned to produce the progress eye-candy when it takes
    too much time before emitting the first line of the result.
@@ -131,8 +133,8 @@ UI, Workflows & Features
 
  * Across the transition at around Git version 2.0, the user used to
    get a pretty loud warning when running "git push" without setting
-   push.default configuration variable.  We no longer warn, given that
-   the transition is over long time ago.
+   push.default configuration variable.  We no longer warn because the
+   transition was completed a long time ago.
 
  * README has been renamed to README.md and its contents got tweaked
    slightly to make it easier on the eyes.
@@ -143,8 +145,8 @@ Performance, Internal Implementation, Development Support etc.
  * Add a framework to spawn a group of processes in parallel, and use
    it to run "git fetch --recurse-submodules" in parallel.
 
- * A slight update to the Makefile to mark "phoney" targets
-   as such correctly.
+ * A slight update to the Makefile to mark ".PHONY" targets as such
+   correctly.
 
  * In-core storage of the reverse index for .pack files (which lets
    you go from a pack offset to an object name) has been streamlined.
@@ -187,14 +189,8 @@ Performance, Internal Implementation, Development Support etc.
  * Some calls to strcpy(3) triggers a false warning from static
    analysers that are less intelligent than humans, and reducing the
    number of these false hits helps us notice real issues.  A few
-   calls to strcpy(3) in test-path-utils that are already safe has
-   been rewritten to avoid false wanings.
-
- * Some calls to strcpy(3) triggers a false warning from static
-   analysers that are less intelligent than humans, and reducing the
-   number of these false hits helps us notice real issues.  A few
-   calls to strcpy(3) in "git rerere" that are already safe has been
-   rewritten to avoid false wanings.
+   calls to strcpy(3) in a couple of protrams that are already safe
+   has been rewritten to avoid false warnings.
 
  * The "name_path" API was an attempt to reduce the need to construct
    the full path out of a series of path components while walking a
@@ -240,6 +236,23 @@ Performance, Internal Implementation, Development Support etc.
  * Out of maintenance gcc on OSX 10.6 fails to compile the code in
    'master'; work it around by using clang by default on the platform.
 
+ * The "name_path" API was an attempt to reduce the need to construct
+   the full path out of a series of path components while walking a
+   tree hierarchy, but over time made less efficient because the path
+   needs to be flattened, e.g. to be compared with another path that
+   is already flat, in many cases.  The API has been removed and its
+   users have been rewritten to simplify the overall code complexity.
+   This incidentally also closes some heap-corruption holes.
+
+ * Recent versions of GNU grep is pickier than before to decide if a
+   file is "binary" and refuse to give line-oriented hits when we
+   expect it to, unless explicitly told with "-a" option.  As our
+   scripted Porcelains use sane_grep wrapper for line-oriented data,
+   even when the line may contain non-ASCII payload we took from
+   end-user data, use "grep -a" to implement sane_grep wrapper when
+   using an implementation of "grep" that takes the "-a" option.
+
+
 
 Also contains various documentation updates and code clean-ups.
 
@@ -334,7 +347,7 @@ notes for details).
  * dirname() emulation has been added, as Msys2 lacks it.
 
  * The underlying machinery used by "ls-files -o" and other commands
-   have been taught not to create empty submodule ref cache for a
+   has been taught not to create empty submodule ref cache for a
    directory that is not a submodule.  This removes a ton of wasted
    CPU cycles.
 

git-svn.html

@@ -2328,6 +2328,8 @@ <h2 id="_configuration">CONFIGURATION</h2>
         url = http://server.org/svn
         fetch = trunk/project-a:refs/remotes/project-a/trunk
         branches = branches/*/project-a:refs/remotes/project-a/branches/*
+        branches = branches/release_*:refs/remotes/project-a/branches/release_*
+        branches = branches/re*se:refs/remotes/project-a/branches/*
         tags = tags/*/project-a:refs/remotes/project-a/tags/*</code></pre>
 </div></div>
 <div class="paragraph"><p>Keep in mind that the <em>*</em> (asterisk) wildcard of the local ref
@@ -2336,6 +2338,17 @@ <h2 id="_configuration">CONFIGURATION</h2>
 independent path component (surrounded by <em>/</em> or EOL).   This
 type of configuration is not automatically created by <em>init</em> and
 should be manually entered with a text-editor or using <em>git config</em>.</p></div>
+<div class="paragraph"><p>Also note that only one asterisk is allowed per word. For example:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>branches = branches/re*se:refs/remotes/project-a/branches/*</code></pre>
+</div></div>
+<div class="paragraph"><p>will match branches <em>release</em>, <em>rese</em>, <em>re123se</em>, however</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>branches = branches/re*s*e:refs/remotes/project-a/branches/*</code></pre>
+</div></div>
+<div class="paragraph"><p>will produce an error.</p></div>
 <div class="paragraph"><p>It is also possible to fetch a subset of branches or tags by using a
 comma-separated list of names within braces. For example:</p></div>
 <div class="listingblock">
@@ -2407,7 +2420,7 @@ <h2 id="_git">GIT</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2015-09-01 16:40:30 PDT
+Last updated 2016-03-16 14:57:44 PDT
 </div>
 </div>
 </body>

git-svn.txt

@@ -1034,6 +1034,8 @@ listed below are allowed:
 	url = http://server.org/svn
 	fetch = trunk/project-a:refs/remotes/project-a/trunk
 	branches = branches/*/project-a:refs/remotes/project-a/branches/*
+	branches = branches/release_*:refs/remotes/project-a/branches/release_*
+	branches = branches/re*se:refs/remotes/project-a/branches/*
 	tags = tags/*/project-a:refs/remotes/project-a/tags/*
 ------------------------------------------------------------------------
 
@@ -1044,6 +1046,16 @@ independent path component (surrounded by '/' or EOL).   This
 type of configuration is not automatically created by 'init' and
 should be manually entered with a text-editor or using 'git config'.
 
+Also note that only one asterisk is allowed per word. For example:
+
+	branches = branches/re*se:refs/remotes/project-a/branches/*
+
+will match branches 'release', 'rese', 're123se', however
+
+	branches = branches/re*s*e:refs/remotes/project-a/branches/*
+
+will produce an error.
+
 It is also possible to fetch a subset of branches or tags by using a
 comma-separated list of names within braces. For example:
 

git.html

@@ -2916,7 +2916,7 @@ <h3 id="_other">other</h3>
 <li>
 <p>
 <code>ssh</code>: git over ssh (including <code>host:path</code> syntax,
-            <code>git+ssh://</code>, etc).
+            <code>ssh://</code>, etc).
 </p>
 </li>
 <li>
@@ -3042,7 +3042,7 @@ <h2 id="_git">GIT</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:54:48 PST
+Last updated 2016-03-16 14:57:44 PDT
 </div>
 </div>
 </body>

git.txt

@@ -1129,7 +1129,7 @@ of clones and fetches.
 	    connection (or proxy, if configured)
 
 	  - `ssh`: git over ssh (including `host:path` syntax,
-	    `git+ssh://`, etc).
+	    `ssh://`, etc).
 
 	  - `http`: git over http, both "smart http" and "dumb http".
 	    Note that this does _not_ include `https`; if you want both,

howto-index.html

@@ -883,7 +883,7 @@ <h1>Git Howto Index</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:38 PST
+Last updated 2016-03-16 14:58:36 PDT
 </div>
 </div>
 </body>

howto/keep-canonical-history-correct.html

@@ -936,7 +936,7 @@ <h1>Keep authoritative canonical history correct with git pull</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:44 PST
+Last updated 2016-03-16 14:58:41 PDT
 </div>
 </div>
 </body>

howto/maintain-git.html

@@ -1433,7 +1433,7 @@ <h3 id="_preparing_a_merge_fix">Preparing a "merge-fix"</h3>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:44 PST
+Last updated 2016-03-16 14:58:42 PDT
 </div>
 </div>
 </body>

howto/new-command.html

@@ -861,7 +861,7 @@ <h2 id="_integrating_a_command">Integrating a command</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:40 PST
+Last updated 2016-03-16 14:58:37 PDT
 </div>
 </div>
 </body>

howto/rebase-from-internal-branch.html

@@ -893,7 +893,7 @@ <h1>How to rebase from an internal branch</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:43 PST
+Last updated 2016-03-16 14:58:41 PDT
 </div>
 </div>
 </body>

howto/rebuild-from-update-hook.html

@@ -845,7 +845,7 @@ <h1>How to rebuild from update hook</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:43 PST
+Last updated 2016-03-16 14:58:41 PDT
 </div>
 </div>
 </body>

howto/recover-corrupted-blob-object.html

@@ -878,7 +878,7 @@ <h1>How to recover a corrupted blob object</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:43 PST
+Last updated 2016-03-16 14:58:40 PDT
 </div>
 </div>
 </body>

howto/recover-corrupted-object-harder.html

@@ -1187,7 +1187,7 @@ <h2 id="_the_adventure_continues_8230">The adventure continues&#8230;</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:43 PST
+Last updated 2016-03-16 14:58:41 PDT
 </div>
 </div>
 </body>

howto/revert-a-faulty-merge.html

@@ -1023,7 +1023,7 @@ <h1>How to revert a faulty merge</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:42 PST
+Last updated 2016-03-16 14:58:40 PDT
 </div>
 </div>
 </body>

howto/revert-branch-rebase.html

@@ -905,7 +905,7 @@ <h1>How to revert an existing commit</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:40 PST
+Last updated 2016-03-16 14:58:38 PDT
 </div>
 </div>
 </body>

howto/separating-topic-branches.html

@@ -839,7 +839,7 @@ <h1>How to separate topic branches</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:42 PST
+Last updated 2016-03-16 14:58:40 PDT
 </div>
 </div>
 </body>

howto/setup-git-server-over-http.html

@@ -1069,7 +1069,7 @@ <h2 id="_troubleshooting">Troubleshooting:</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:42 PST
+Last updated 2016-03-16 14:58:39 PDT
 </div>
 </div>
 </body>

howto/update-hook-example.html

@@ -928,7 +928,7 @@ <h1>How to use the update hook</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:41 PST
+Last updated 2016-03-16 14:58:39 PDT
 </div>
 </div>
 </body>

howto/use-git-daemon.html

@@ -789,7 +789,7 @@ <h1>How to use git-daemon</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:41 PST
+Last updated 2016-03-16 14:58:39 PDT
 </div>
 </div>
 </body>

howto/using-merge-subtree.html

@@ -846,7 +846,7 @@ <h2 id="_additional_tips">Additional tips</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:40 PST
+Last updated 2016-03-16 14:58:38 PDT
 </div>
 </div>
 </body>

howto/using-signed-tag-in-pull-request.html

@@ -950,7 +950,7 @@ <h2 id="_auditors">Auditors</h2>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:41 PST
+Last updated 2016-03-16 14:58:38 PDT
 </div>
 </div>
 </body>

technical/api-index.html

@@ -898,7 +898,7 @@ <h1>Git API Documents</h1>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-03-10 14:55:53 PST
+Last updated 2016-03-16 14:58:49 PDT
 </div>
 </div>
 </body>