--- /dev/null
+GIT v1.5.2.2 Release Notes
+==========================
+
+Fixes since v1.5.2.1
+--------------------
+
+* Usability fix
+
+ - git-gui is shipped with its updated blame interface. It is
+ rumored that the older one was not just unusable but was
+ active health hazard, but this one is actually pretty.
+ Please see for yourself.
+
+* Bugfixes
+
+ - "git checkout fubar" was utterly confused when there is a
+ branch fubar and a tag fubar at the same time. It correctly
+ checks out the branch fubar now.
+
+ - "git clone /path/foo" to clone a local /path/foo.git
+ repository left an incorrect configuration.
+
+ - "git send-email" correctly unquotes RFC 2047 quoted names in
+ the patch-email before using their values.
+
+ - We did not accept number of seconds since epoch older than
+ year 2000 as a valid timestamp. We now interpret positive
+ integers more than 8 digits as such, which allows us to
+ express timestamps more recent than March 1973.
+
+ - git-cvsimport did not work when you have GIT_DIR to point
+ your repository at a nonstandard location.
+
+ - Some systems (notably, Solaris) lack hstrerror() to make
+ h_errno human readable; prepare a replacement
+ implementation.
+
+ - .gitignore file listed git-core.spec but what we generate is
+ git.spec, and nobody noticed for a long time.
+
+ - "git-merge-recursive" does not try to run file level merge
+ on binary files.
+
+ - "git-branch --track" did not create tracking configuration
+ correctly when the branch name had slash in it.
+
+ - The email address of the user specified with user.email
+ configuration was overriden by EMAIL environment variable.
+
+ - The tree parser did not warn about tree entries with
+ nonsense file modes, and assumed they must be blobs.
+
+ - "git log -z" without any other request to generate diff still
+ invoked the diff machinery, wasting cycles.
+
+* Documentation
+
+ - Many updates to fix stale or missing documentation.
+
+ - Although our documentation was primarily meant to be formatted
+ with AsciiDoc7, formatting with AsciiDoc8 is supported better.
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:42 UTC\r
+Last updated 16-Jun-2007 09:49:30 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:43 UTC\r
+Last updated 16-Jun-2007 09:49:30 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:43 UTC\r
+Last updated 16-Jun-2007 09:49:31 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:44 UTC\r
+Last updated 16-Jun-2007 09:49:32 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:07:59 UTC\r
+Last updated 16-Jun-2007 09:48:53 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:07:59 UTC\r
+Last updated 16-Jun-2007 09:48:53 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:00 UTC\r
+Last updated 16-Jun-2007 09:48:54 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:00 UTC\r
+Last updated 16-Jun-2007 09:48:54 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:00 UTC\r
+Last updated 16-Jun-2007 09:48:54 UTC\r
</div>\r
</div>\r
</body>\r
</p>\r
</dd>\r
<dt>\r
-git archive --format=tar --prefix=git-1.4.0/ v1.4.0^{tree} | gzip >git-1.4.0.tar.gz\r
+git archive --format=tar --prefix=git-1.4.0/ v1.4.0^{tree} | gzip >git-1.4.0.tar.gz\r
</dt>\r
<dd>\r
<p>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 09-Jun-2007 20:38:59 UTC\r
+Last updated 16-Jun-2007 09:48:54 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:01 UTC\r
+Last updated 16-Jun-2007 09:48:55 UTC\r
</div>\r
</div>\r
</body>\r
<pre><tt>git log --diff-filter=A --pretty=short -- foo</tt></pre>\r
</div></div>\r
<p>and then annotate the change between the commit and its\r
-parents, using <tt>commit^!</tt> notation:</p>\r
+parents, using <tt>commit^!</tt> notation:</p>\r
<div class="literalblock">\r
<div class="content">\r
<pre><tt>git blame -C -C -f $commit^! -- foo</tt></pre>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 13-Jun-2007 08:29:16 UTC\r
+Last updated 16-Jun-2007 09:48:55 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:02 UTC\r
+Last updated 16-Jun-2007 09:48:55 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:02 UTC\r
+Last updated 16-Jun-2007 09:48:55 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:02 UTC\r
+Last updated 16-Jun-2007 09:48:56 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:02 UTC\r
+Last updated 16-Jun-2007 09:48:56 UTC\r
</div>\r
</div>\r
</body>\r
<p>\r
It cannot have ASCII control character (i.e. bytes whose\r
values are lower than \040, or \177 <tt>DEL</tt>), space, tilde <tt>~</tt>,\r
- caret <tt>^</tt>, colon <tt>:</tt>, question-mark <tt>?</tt>, asterisk <tt>*</tt>,\r
+ caret <tt>^</tt>, colon <tt>:</tt>, question-mark <tt>?</tt>, asterisk <tt>*</tt>,\r
or open bracket <tt>[</tt> anywhere;\r
</p>\r
</li>\r
<li>\r
<p>\r
double-dot <tt>..</tt> are often used as in <tt>ref1..ref2</tt>, and in some\r
- context this notation means <tt>^ref1 ref2</tt> (i.e. not in\r
+ context this notation means <tt>^ref1 ref2</tt> (i.e. not in\r
ref1 and in ref2).\r
</p>\r
</li>\r
<li>\r
<p>\r
-tilde <tt>~</tt> and caret <tt>^</tt> are used to introduce postfix\r
+tilde <tt>~</tt> and caret <tt>^</tt> are used to introduce postfix\r
<em>nth parent</em> and <em>peel onion</em> operation.\r
</p>\r
</li>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:03 UTC\r
+Last updated 16-Jun-2007 09:48:56 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:03 UTC\r
+Last updated 16-Jun-2007 09:48:56 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:03 UTC\r
+Last updated 16-Jun-2007 09:48:56 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:03 UTC\r
+Last updated 16-Jun-2007 09:48:57 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:47 UTC\r
+Last updated 16-Jun-2007 09:48:57 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:04 UTC\r
+Last updated 16-Jun-2007 09:48:57 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 09-Jun-2007 20:38:59 UTC\r
+Last updated 16-Jun-2007 09:48:57 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:04 UTC\r
+Last updated 16-Jun-2007 09:48:57 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:04 UTC\r
+Last updated 16-Jun-2007 09:48:58 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 11-Jun-2007 01:21:26 UTC\r
+Last updated 16-Jun-2007 09:48:58 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:05 UTC\r
+Last updated 16-Jun-2007 09:48:58 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:05 UTC\r
+Last updated 16-Jun-2007 09:48:59 UTC\r
</div>\r
</div>\r
</body>\r
</div></div>\r
</dd>\r
<dt>\r
-Merge pending patches into CVS automatically — only if you really know what you are doing \r
+Merge pending patches into CVS automatically — only if you really know what you are doing\r
</dt>\r
<dd>\r
<div class="listingblock">\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:06 UTC\r
+Last updated 16-Jun-2007 09:48:59 UTC\r
</div>\r
</div>\r
</body>\r
$ cvs commit -F .mgs <files>
------------
-Merge pending patches into CVS automatically -- only if you really know what you are doing ::
+Merge pending patches into CVS automatically -- only if you really know what you are doing::
+
------------
$ export GIT_DIR=~/project/.git
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 13-Jun-2007 08:29:16 UTC\r
+Last updated 16-Jun-2007 09:48:59 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<h2>SYNOPSIS</h2>\r
<div class="sectionbody">\r
+<p>SSH:</p>\r
<div class="verseblock">\r
<div class="content">export CVS_SERVER=git-cvsserver\r
<em>cvs</em> -d :ext:user@server/path/repo.git co <HEAD_name></div></div>\r
+<p>pserver (/etc/inetd.conf):</p>\r
+<div class="verseblock">\r
+<div class="content">cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver</div></div>\r
+<p>Usage:</p>\r
+<div class="verseblock">\r
+<div class="content"><em>git-cvsserver</em> [options] [pserver|server] [<directory> …]</div></div>\r
+</div>\r
+<h2>OPTIONS</h2>\r
+<div class="sectionbody">\r
+<p>All these options obviously only make sense if enforced by the server side.\r
+They have been implemented to resemble the <a href="git-daemon.html">git-daemon(1)</a> options as\r
+closely as possible.</p>\r
+<dl>\r
+<dt>\r
+--base-path <path>\r
+</dt>\r
+<dd>\r
+<p>\r
+Prepend <em>path</em> to requested CVSROOT\r
+</p>\r
+</dd>\r
+<dt>\r
+--strict-paths\r
+</dt>\r
+<dd>\r
+<p>\r
+Don't allow recursing into subdirectories\r
+</p>\r
+</dd>\r
+<dt>\r
+--export-all\r
+</dt>\r
+<dd>\r
+<p>\r
+Don't check for <tt>gitcvs.enabled</tt> in config. You also have to specify a list\r
+of allowed directories (see below) if you want to use this option.\r
+</p>\r
+</dd>\r
+<dt>\r
+--version, -V\r
+</dt>\r
+<dd>\r
+<p>\r
+Print version information and exit\r
+</p>\r
+</dd>\r
+<dt>\r
+--help, -h, -H\r
+</dt>\r
+<dd>\r
+<p>\r
+Print usage information and exit\r
+</p>\r
+</dd>\r
+<dt>\r
+<directory>\r
+</dt>\r
+<dd>\r
+<p>\r
+You can specify a list of allowed directories. If no directories\r
+are given, all are allowed. This is an additional restriction, gitcvs\r
+access still needs to be enabled by the <tt>gitcvs.enabled</tt> config option\r
+unless <em>--export-all</em> was given, too.\r
+</p>\r
+</dd>\r
+</dl>\r
</div>\r
<h2>DESCRIPTION</h2>\r
<div class="sectionbody">\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:07 UTC\r
+Last updated 16-Jun-2007 09:48:59 UTC\r
</div>\r
</div>\r
</body>\r
SYNOPSIS
--------
+
+SSH:
+
[verse]
export CVS_SERVER=git-cvsserver
'cvs' -d :ext:user@server/path/repo.git co <HEAD_name>
+pserver (/etc/inetd.conf):
+
+[verse]
+cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver
+
+Usage:
+
+[verse]
+'git-cvsserver' [options] [pserver|server] [<directory> ...]
+
+OPTIONS
+-------
+
+All these options obviously only make sense if enforced by the server side.
+They have been implemented to resemble the gitlink:git-daemon[1] options as
+closely as possible.
+
+--base-path <path>::
+Prepend 'path' to requested CVSROOT
+
+--strict-paths::
+Don't allow recursing into subdirectories
+
+--export-all::
+Don't check for `gitcvs.enabled` in config. You also have to specify a list
+of allowed directories (see below) if you want to use this option.
+
+--version, -V::
+Print version information and exit
+
+--help, -h, -H::
+Print usage information and exit
+
+<directory>::
+You can specify a list of allowed directories. If no directories
+are given, all are allowed. This is an additional restriction, gitcvs
+access still needs to be enabled by the `gitcvs.enabled` config option
+unless '--export-all' was given, too.
+
+
DESCRIPTION
-----------
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:07 UTC\r
+Last updated 16-Jun-2007 09:49:00 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:07 UTC\r
+Last updated 16-Jun-2007 09:49:00 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:47 UTC\r
+Last updated 16-Jun-2007 09:49:00 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:47 UTC\r
+Last updated 16-Jun-2007 09:49:00 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:48 UTC\r
+Last updated 16-Jun-2007 09:49:01 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:48 UTC\r
+Last updated 16-Jun-2007 09:49:02 UTC\r
</div>\r
</div>\r
</body>\r
<div class="content">\r
<pre><tt> from refs/heads/branch^0</tt></pre>\r
</div></div>\r
-<p>The <tt>^0</tt> suffix is necessary as fast-import does not permit a branch to\r
+<p>The <tt>^0</tt> suffix is necessary as fast-import does not permit a branch to\r
start from itself, and the branch is created in memory before the\r
-<tt>from</tt> command is even read from the input. Adding <tt>^0</tt> will force\r
+<tt>from</tt> command is even read from the input. Adding <tt>^0</tt> will force\r
fast-import to resolve the commit through Git's revision parsing library,\r
rather than its internal branch table, thereby loading in the\r
existing value of the branch.</p>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:10 UTC\r
+Last updated 16-Jun-2007 09:49:03 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:10 UTC\r
+Last updated 16-Jun-2007 09:49:03 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:11 UTC\r
+Last updated 16-Jun-2007 09:49:04 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:11 UTC\r
+Last updated 16-Jun-2007 09:49:06 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:11 UTC\r
+Last updated 16-Jun-2007 09:49:06 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:49 UTC\r
+Last updated 16-Jun-2007 09:49:06 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:12 UTC\r
+Last updated 16-Jun-2007 09:49:06 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:12 UTC\r
+Last updated 16-Jun-2007 09:49:06 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:13 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:13 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:14 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:13 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:14 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:14 UTC\r
+Last updated 16-Jun-2007 09:49:07 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:14 UTC\r
+Last updated 16-Jun-2007 09:49:08 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:15 UTC\r
+Last updated 16-Jun-2007 09:49:08 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:15 UTC\r
+Last updated 16-Jun-2007 09:49:08 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:15 UTC\r
+Last updated 16-Jun-2007 09:49:09 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:15 UTC\r
+Last updated 16-Jun-2007 09:49:09 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:16 UTC\r
+Last updated 16-Jun-2007 09:49:09 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:16 UTC\r
+Last updated 16-Jun-2007 09:49:10 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:16 UTC\r
+Last updated 16-Jun-2007 09:49:10 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:16 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:17 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:17 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:17 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:17 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:17 UTC\r
+Last updated 16-Jun-2007 09:49:11 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:18 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:18 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:18 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:18 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:19 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 11-Jun-2007 01:21:26 UTC\r
+Last updated 16-Jun-2007 09:49:12 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 11-Jun-2007 01:21:27 UTC\r
+Last updated 16-Jun-2007 09:49:13 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:19 UTC\r
+Last updated 16-Jun-2007 09:49:13 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:20 UTC\r
+Last updated 16-Jun-2007 09:49:13 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:20 UTC\r
+Last updated 16-Jun-2007 09:49:14 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:21 UTC\r
+Last updated 16-Jun-2007 09:49:14 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:21 UTC\r
+Last updated 16-Jun-2007 09:49:14 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:22 UTC\r
+Last updated 16-Jun-2007 09:49:14 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:22 UTC\r
+Last updated 16-Jun-2007 09:49:14 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:22 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:22 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:23 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:23 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 09-Jun-2007 20:38:59 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:24 UTC\r
+Last updated 16-Jun-2007 09:49:15 UTC\r
</div>\r
</div>\r
</body>\r
refs that exist both on the local side and on the remote\r
side are updated.</p>\r
<p><tt>tag <tag></tt> means the same as <tt>refs/tags/<tag>:refs/tags/<tag></tt>.</p>\r
-<p>A parameter <ref> without a colon is equivalent to\r
-<ref><tt>:</tt><ref>, hence updates <ref> in the destination from <ref>\r
-in the source.</p>\r
+<p>A parameter <ref> without a colon pushes the <ref> from the source\r
+repository to the destination repository under the same name.</p>\r
<p>Pushing an empty <src> allows you to delete the <dst> ref from\r
the remote repository.</p>\r
</dd>\r
Pull: refs/heads/<head>:<remote></tt></pre>\r
</div></div>\r
</div>\r
+<h2>Examples</h2>\r
+<div class="sectionbody">\r
+<dl>\r
+<dt>\r
+git push origin master\r
+</dt>\r
+<dd>\r
+<p>\r
+ Find a ref that matches <tt>master</tt> in the source repository\r
+ (most likely, it would find <tt>refs/heads/master</tt>), and update\r
+ the same ref (e.g. <tt>refs/heads/master</tt>) in <tt>origin</tt> repository\r
+ with it.\r
+</p>\r
+</dd>\r
+<dt>\r
+git push origin :experimental\r
+</dt>\r
+<dd>\r
+<p>\r
+ Find a ref that matches <tt>experimental</tt> in the <tt>origin</tt> repository\r
+ (e.g. <tt>refs/heads/experimental</tt>), and delete it.\r
+</p>\r
+</dd>\r
+<dt>\r
+git push origin master:satellite/master\r
+</dt>\r
+<dd>\r
+<p>\r
+ Find a ref that matches <tt>master</tt> in the source repository\r
+ (most likely, it would find <tt>refs/heads/master</tt>), and update\r
+ the ref that matches <tt>satellite/master</tt> (most likely, it would\r
+ be <tt>refs/remotes/satellite/master</tt>) in <tt>origin</tt> repository with it.\r
+</p>\r
+</dd>\r
+</dl>\r
+</div>\r
<h2>Author</h2>\r
<div class="sectionbody">\r
<p>Written by Junio C Hamano <junkio@cox.net>, later rewritten in C\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:24 UTC\r
+Last updated 16-Jun-2007 09:49:16 UTC\r
</div>\r
</div>\r
</body>\r
+
`tag <tag>` means the same as `refs/tags/<tag>:refs/tags/<tag>`.
+
-A parameter <ref> without a colon is equivalent to
-<ref>`:`<ref>, hence updates <ref> in the destination from <ref>
-in the source.
+A parameter <ref> without a colon pushes the <ref> from the source
+repository to the destination repository under the same name.
+
Pushing an empty <src> allows you to delete the <dst> ref from
the remote repository.
include::urls.txt[]
+
+Examples
+--------
+
+git push origin master::
+ Find a ref that matches `master` in the source repository
+ (most likely, it would find `refs/heads/master`), and update
+ the same ref (e.g. `refs/heads/master`) in `origin` repository
+ with it.
+
+git push origin :experimental::
+ Find a ref that matches `experimental` in the `origin` repository
+ (e.g. `refs/heads/experimental`), and delete it.
+
+git push origin master:satellite/master::
+ Find a ref that matches `master` in the source repository
+ (most likely, it would find `refs/heads/master`), and update
+ the ref that matches `satellite/master` (most likely, it would
+ be `refs/remotes/satellite/master`) in `origin` repository with it.
+
Author
------
Written by Junio C Hamano <junkio@cox.net>, later rewritten in C
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:25 UTC\r
+Last updated 16-Jun-2007 09:49:16 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:25 UTC\r
+Last updated 16-Jun-2007 09:49:16 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:26 UTC\r
+Last updated 16-Jun-2007 09:49:16 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:26 UTC\r
+Last updated 16-Jun-2007 09:49:17 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:26 UTC\r
+Last updated 16-Jun-2007 09:49:17 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:27 UTC\r
+Last updated 16-Jun-2007 09:49:18 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:27 UTC\r
+Last updated 16-Jun-2007 09:49:18 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:27 UTC\r
+Last updated 16-Jun-2007 09:49:18 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:28 UTC\r
+Last updated 16-Jun-2007 09:49:19 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:28 UTC\r
+Last updated 16-Jun-2007 09:49:19 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:28 UTC\r
+Last updated 16-Jun-2007 09:49:19 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:28 UTC\r
+Last updated 16-Jun-2007 09:49:19 UTC\r
</div>\r
</div>\r
</body>\r
<p>Lists commit objects in reverse chronological order starting at the\r
given commit(s), taking ancestry relationship into account. This is\r
useful to produce human-readable log output.</p>\r
-<p>Commits which are stated with a preceding <em>^</em> cause listing to\r
+<p>Commits which are stated with a preceding <em>^</em> cause listing to\r
stop at that point. Their parents are implied. Thus the following\r
command:</p>\r
<div class="listingblock">\r
<p>means "list all the commits which are included in <em>foo</em> and <em>bar</em>, but\r
not in <em>baz</em>".</p>\r
<p>A special notation "<em><commit1></em>..<em><commit2></em>" can be used as a\r
-short-hand for "^<em><commit1></em> <em><commit2></em>". For example, either of\r
+short-hand for "^<em><commit1></em> <em><commit2></em>". For example, either of\r
the following may be used interchangeably:</p>\r
<div class="listingblock">\r
<div class="content">\r
</dt>\r
<dd>\r
<p>\r
- Reverses the meaning of the <em>^</em> prefix (or lack thereof)\r
+ Reverses the meaning of the <em>^</em> prefix (or lack thereof)\r
for all following revision specifiers, up to the next <em>--not</em>.\r
</p>\r
</dd>\r
Instead of walking the commit ancestry chain, walk\r
reflog entries from the most recent one to older ones.\r
When this option is used you cannot specify commits to\r
- exclude (that is, <em>^commit</em>, <em>commit1..commit2</em>,\r
+ exclude (that is, <em>^commit</em>, <em>commit1..commit2</em>,\r
nor <em>commit1…commit2</em> notations cannot be used).<br />\r
With <em>--pretty</em> format other than oneline (for obvious reasons),\r
this causes the output to have two extra lines of information\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:28 UTC\r
+Last updated 16-Jun-2007 09:49:19 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- When showing object names, prefix them with <em>^</em> and\r
- strip <em>^</em> prefix from the object names that already have\r
+ When showing object names, prefix them with <em>^</em> and\r
+ strip <em>^</em> prefix from the object names that already have\r
one.\r
</p>\r
</dd>\r
<dd>\r
<p>\r
Usually the object names are output in SHA1 form (with\r
- possible <em>^</em> prefix); this option makes them output in a\r
+ possible <em>^</em> prefix); this option makes them output in a\r
form as close to the original input as possible.\r
</p>\r
</dd>\r
</li>\r
<li>\r
<p>\r
-A suffix <em>^</em> to a revision parameter means the first parent of\r
- that commit object. <em>^<n></em> means the <n>th parent (i.e.\r
- <em>rev^</em>\r
- is equivalent to <em>rev^1</em>). As a special rule,\r
- <em>rev^0</em> means the commit itself and is used when <em>rev</em> is the\r
+A suffix <em>^</em> to a revision parameter means the first parent of\r
+ that commit object. <em>^<n></em> means the <n>th parent (i.e.\r
+ <em>rev^</em>\r
+ is equivalent to <em>rev^1</em>). As a special rule,\r
+ <em>rev^0</em> means the commit itself and is used when <em>rev</em> is the\r
object name of a tag object that refers to a commit object.\r
</p>\r
</li>\r
A suffix <em>~<n></em> to a revision parameter means the commit\r
object that is the <n>th generation grand-parent of the named\r
commit object, following only the first parent. I.e. rev~3 is\r
- equivalent to rev^^^ which is equivalent to\r
- rev^1^1^1. See below for a illustration of\r
+ equivalent to rev^^^ which is equivalent to\r
+ rev^1^1^1. See below for a illustration of\r
the usage of this form.\r
</p>\r
</li>\r
<li>\r
<p>\r
-A suffix <em>^</em> followed by an object type name enclosed in\r
- brace pair (e.g. <tt>v0.99.8^{commit}</tt>) means the object\r
+A suffix <em>^</em> followed by an object type name enclosed in\r
+ brace pair (e.g. <tt>v0.99.8^{commit}</tt>) means the object\r
could be a tag, and dereference the tag recursively until an\r
object of that type is found or the object cannot be\r
- dereferenced anymore (in which case, barf). <tt>rev^0</tt>\r
- introduced earlier is a short-hand for <tt>rev^{commit}</tt>.\r
+ dereferenced anymore (in which case, barf). <tt>rev^0</tt>\r
+ introduced earlier is a short-hand for <tt>rev^{commit}</tt>.\r
</p>\r
</li>\r
<li>\r
<p>\r
-A suffix <em>^</em> followed by an empty brace pair\r
- (e.g. <tt>v0.99.8^{}</tt>) means the object could be a tag,\r
+A suffix <em>^</em> followed by an empty brace pair\r
+ (e.g. <tt>v0.99.8^{}</tt>) means the object could be a tag,\r
and dereference the tag recursively until a non-tag object is\r
found.\r
</p>\r
specifying a single revision with the notation described in the\r
previous section means the set of commits reachable from that\r
commit, following the commit ancestry chain.</p>\r
-<p>To exclude commits reachable from a commit, a prefix <tt>^</tt>\r
-notation is used. E.g. "<tt>^r1 r2</tt>" means commits reachable\r
+<p>To exclude commits reachable from a commit, a prefix <tt>^</tt>\r
+notation is used. E.g. "<tt>^r1 r2</tt>" means commits reachable\r
from <tt>r2</tt> but exclude the ones reachable from <tt>r1</tt>.</p>\r
<p>This set operation appears so often that there is a shorthand\r
-for it. "<tt>r1..r2</tt>" is equivalent to "<tt>^r1 r2</tt>". It is\r
+for it. "<tt>r1..r2</tt>" is equivalent to "<tt>^r1 r2</tt>". It is\r
the difference of two sets (subtract the set of commits\r
reachable from <tt>r1</tt> from the set of commits reachable from\r
<tt>r2</tt>).</p>\r
It is the set of commits that are reachable from either one of\r
<tt>r1</tt> or <tt>r2</tt> but not from both.</p>\r
<p>Two other shorthands for naming a set that is formed by a commit\r
-and its parent commits exists. <tt>r1^@</tt> notation means all\r
-parents of <tt>r1</tt>. <tt>r1^!</tt> includes commit <tt>r1</tt> but excludes\r
+and its parent commits exists. <tt>r1^@</tt> notation means all\r
+parents of <tt>r1</tt>. <tt>r1^!</tt> includes commit <tt>r1</tt> but excludes\r
its all parents.</p>\r
<p>Here are a handful examples:</p>\r
<div class="literalblock">\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:29 UTC\r
+Last updated 16-Jun-2007 09:49:20 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:29 UTC\r
+Last updated 16-Jun-2007 09:49:20 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:30 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:30 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:30 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:31 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:31 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:31 UTC\r
+Last updated 16-Jun-2007 09:49:21 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:32 UTC\r
+Last updated 16-Jun-2007 09:49:22 UTC\r
</div>\r
</div>\r
</body>\r
This helps track topic branches by hiding any commit that\r
is already in the main line of development. When given\r
"git show-branch --topics master topic1 topic2", this\r
- will show the revisions given by "git rev-list ^master\r
+ will show the revisions given by "git rev-list ^master\r
topic1 topic2"\r
</p>\r
</dd>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:32 UTC\r
+Last updated 16-Jun-2007 09:49:22 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:32 UTC\r
+Last updated 16-Jun-2007 09:49:22 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:32 UTC\r
+Last updated 16-Jun-2007 09:49:22 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:33 UTC\r
+Last updated 16-Jun-2007 09:49:22 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:33 UTC\r
+Last updated 16-Jun-2007 09:49:23 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:33 UTC\r
+Last updated 16-Jun-2007 09:49:23 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:34 UTC\r
+Last updated 16-Jun-2007 09:49:23 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:34 UTC\r
+Last updated 16-Jun-2007 09:49:23 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 12-Jun-2007 16:08:49 UTC\r
+Last updated 16-Jun-2007 09:49:24 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:34 UTC\r
+Last updated 16-Jun-2007 09:49:24 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:35 UTC\r
+Last updated 16-Jun-2007 09:49:24 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:35 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:35 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</p>\r
</dd>\r
<dt>\r
-git tar-tree v1.4.0^{tree} git-1.4.0 | gzip >git-1.4.0.tar.gz\r
+git tar-tree v1.4.0^{tree} git-1.4.0 | gzip >git-1.4.0.tar.gz\r
</dt>\r
<dd>\r
<p>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:36 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:45 UTC\r
+Last updated 16-Jun-2007 09:49:32 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:36 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:36 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:37 UTC\r
+Last updated 16-Jun-2007 09:49:25 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:37 UTC\r
+Last updated 16-Jun-2007 09:49:26 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:37 UTC\r
+Last updated 16-Jun-2007 09:49:26 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:37 UTC\r
+Last updated 16-Jun-2007 09:49:26 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:38 UTC\r
+Last updated 16-Jun-2007 09:49:26 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:38 UTC\r
+Last updated 16-Jun-2007 09:49:26 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:38 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:38 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:38 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:39 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 09-Jun-2007 20:38:59 UTC\r
+Last updated 16-Jun-2007 09:49:28 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:39 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:39 UTC\r
+Last updated 16-Jun-2007 09:49:28 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:39 UTC\r
+Last updated 16-Jun-2007 09:49:27 UTC\r
</div>\r
</div>\r
</body>\r
--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
+<head>\r
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
+<meta name="generator" content="AsciiDoc 7.0.2" />\r
+<style type="text/css">\r
+/* Debug borders */\r
+p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
+/*\r
+ border: 1px solid red;\r
+*/\r
+}\r
+\r
+body {\r
+ margin: 1em 5% 1em 5%;\r
+}\r
+\r
+a { color: blue; }\r
+a:visited { color: fuchsia; }\r
+\r
+em {\r
+ font-style: italic;\r
+}\r
+\r
+strong {\r
+ font-weight: bold;\r
+}\r
+\r
+tt {\r
+ color: navy;\r
+}\r
+\r
+h1, h2, h3, h4, h5, h6 {\r
+ color: #527bbd;\r
+ font-family: sans-serif;\r
+ margin-top: 1.2em;\r
+ margin-bottom: 0.5em;\r
+ line-height: 1.3;\r
+}\r
+\r
+h1 {\r
+ border-bottom: 2px solid silver;\r
+}\r
+h2 {\r
+ border-bottom: 2px solid silver;\r
+ padding-top: 0.5em;\r
+}\r
+\r
+div.sectionbody {\r
+ font-family: serif;\r
+ margin-left: 0;\r
+}\r
+\r
+hr {\r
+ border: 1px solid silver;\r
+}\r
+\r
+p {\r
+ margin-top: 0.5em;\r
+ margin-bottom: 0.5em;\r
+}\r
+\r
+pre {\r
+ padding: 0;\r
+ margin: 0;\r
+}\r
+\r
+span#author {\r
+ color: #527bbd;\r
+ font-family: sans-serif;\r
+ font-weight: bold;\r
+ font-size: 1.2em;\r
+}\r
+span#email {\r
+}\r
+span#revision {\r
+ font-family: sans-serif;\r
+}\r
+\r
+div#footer {\r
+ font-family: sans-serif;\r
+ font-size: small;\r
+ border-top: 2px solid silver;\r
+ padding-top: 0.5em;\r
+ margin-top: 4.0em;\r
+}\r
+div#footer-text {\r
+ float: left;\r
+ padding-bottom: 0.5em;\r
+}\r
+div#footer-badges {\r
+ float: right;\r
+ padding-bottom: 0.5em;\r
+}\r
+\r
+div#preamble,\r
+div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
+div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
+div.admonitionblock {\r
+ margin-right: 10%;\r
+ margin-top: 1.5em;\r
+ margin-bottom: 1.5em;\r
+}\r
+div.admonitionblock {\r
+ margin-top: 2.5em;\r
+ margin-bottom: 2.5em;\r
+}\r
+\r
+div.content { /* Block element content. */\r
+ padding: 0;\r
+}\r
+\r
+/* Block element titles. */\r
+div.title, caption.title {\r
+ font-family: sans-serif;\r
+ font-weight: bold;\r
+ text-align: left;\r
+ margin-top: 1.0em;\r
+ margin-bottom: 0.5em;\r
+}\r
+div.title + * {\r
+ margin-top: 0;\r
+}\r
+\r
+td div.title:first-child {\r
+ margin-top: 0.0em;\r
+}\r
+div.content div.title:first-child {\r
+ margin-top: 0.0em;\r
+}\r
+div.content + div.title {\r
+ margin-top: 0.0em;\r
+}\r
+\r
+div.sidebarblock > div.content {\r
+ background: #ffffee;\r
+ border: 1px solid silver;\r
+ padding: 0.5em;\r
+}\r
+\r
+div.listingblock > div.content {\r
+ border: 1px solid silver;\r
+ background: #f4f4f4;\r
+ padding: 0.5em;\r
+}\r
+\r
+div.quoteblock > div.content {\r
+ padding-left: 2.0em;\r
+}\r
+div.quoteblock .attribution {\r
+ text-align: right;\r
+}\r
+\r
+div.admonitionblock .icon {\r
+ vertical-align: top;\r
+ font-size: 1.1em;\r
+ font-weight: bold;\r
+ text-decoration: underline;\r
+ color: #527bbd;\r
+ padding-right: 0.5em;\r
+}\r
+div.admonitionblock td.content {\r
+ padding-left: 0.5em;\r
+ border-left: 2px solid silver;\r
+}\r
+\r
+div.exampleblock > div.content {\r
+ border-left: 2px solid silver;\r
+ padding: 0.5em;\r
+}\r
+\r
+div.verseblock div.content {\r
+ white-space: pre;\r
+}\r
+\r
+div.imageblock div.content { padding-left: 0; }\r
+div.imageblock img { border: 1px solid silver; }\r
+span.image img { border-style: none; }\r
+\r
+dl {\r
+ margin-top: 0.8em;\r
+ margin-bottom: 0.8em;\r
+}\r
+dt {\r
+ margin-top: 0.5em;\r
+ margin-bottom: 0;\r
+ font-style: italic;\r
+}\r
+dd > *:first-child {\r
+ margin-top: 0;\r
+}\r
+\r
+ul, ol {\r
+ list-style-position: outside;\r
+}\r
+ol.olist2 {\r
+ list-style-type: lower-alpha;\r
+}\r
+\r
+div.tableblock > table {\r
+ border-color: #527bbd;\r
+ border-width: 3px;\r
+}\r
+thead {\r
+ font-family: sans-serif;\r
+ font-weight: bold;\r
+}\r
+tfoot {\r
+ font-weight: bold;\r
+}\r
+\r
+div.hlist {\r
+ margin-top: 0.8em;\r
+ margin-bottom: 0.8em;\r
+}\r
+td.hlist1 {\r
+ vertical-align: top;\r
+ font-style: italic;\r
+ padding-right: 0.8em;\r
+}\r
+td.hlist2 {\r
+ vertical-align: top;\r
+}\r
+\r
+@media print {\r
+ div#footer-badges { display: none; }\r
+}\r
+include::./stylesheets/xhtml11-manpage.css[]\r
+/* Workarounds for IE6's broken and incomplete CSS2. */\r
+\r
+div.sidebar-content {\r
+ background: #ffffee;\r
+ border: 1px solid silver;\r
+ padding: 0.5em;\r
+}\r
+div.sidebar-title, div.image-title {\r
+ font-family: sans-serif;\r
+ font-weight: bold;\r
+ margin-top: 0.0em;\r
+ margin-bottom: 0.5em;\r
+}\r
+\r
+div.listingblock div.content {\r
+ border: 1px solid silver;\r
+ background: #f4f4f4;\r
+ padding: 0.5em;\r
+}\r
+\r
+div.quoteblock-content {\r
+ padding-left: 2.0em;\r
+}\r
+\r
+div.exampleblock-content {\r
+ border-left: 2px solid silver;\r
+ padding-left: 0.5em;\r
+}\r
+</style>\r
+<title>gitmodules(5)</title>\r
+</head>\r
+<body>\r
+<div id="header">\r
+<h1>\r
+gitmodules(5) Manual Page\r
+</h1>\r
+<h2>NAME</h2>\r
+<div class="sectionbody">\r
+<p>gitmodules -\r
+ defining submodule properties\r
+</p>\r
+</div>\r
+</div>\r
+<h2>SYNOPSIS</h2>\r
+<div class="sectionbody">\r
+<p>gitmodules</p>\r
+</div>\r
+<h2>DESCRIPTION</h2>\r
+<div class="sectionbody">\r
+<p>The <tt>.gitmodules</tt> file, located in the top-level directory of a git\r
+working tree, is a text file with a syntax matching the requirements\r
+of <a href="git-config.html">git-config(1)</a>.</p>\r
+<p>The file contains one subsection per submodule, and the subsection value\r
+is the name of the submodule. Each submodule section also contains the\r
+following required keys:</p>\r
+<dl>\r
+<dt>\r
+submodule.<name>.path\r
+</dt>\r
+<dd>\r
+<p>\r
+ Defines the path, relative to the top-level directory of the git\r
+ working tree, where the submodule is expected to be checked out.\r
+ The path name must not end with a <tt>/</tt>. All submodule paths must\r
+ be unique within the .gitmodules file.\r
+</p>\r
+</dd>\r
+<dt>\r
+submodule.<name>.url\r
+</dt>\r
+<dd>\r
+<p>\r
+ Defines an url from where the submodule repository can be cloned.\r
+</p>\r
+</dd>\r
+</dl>\r
+</div>\r
+<h2>EXAMPLES</h2>\r
+<div class="sectionbody">\r
+<p>Consider the following .gitmodules file:</p>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>[submodule "libfoo"]\r
+ path = include/foo\r
+ url = git://foo.com/git/lib.git</tt></pre>\r
+</div></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>[submodule "libbar"]\r
+ path = include/bar\r
+ url = git://bar.com/git/lib.git</tt></pre>\r
+</div></div>\r
+<p>This defines two submodules, <tt>libfoo</tt> and <tt>libbar</tt>. These are expected to\r
+be checked out in the paths <em>include/foo</em> and <em>include/bar</em>, and for both\r
+submodules an url is specified which can be used for cloning the submodules.</p>\r
+</div>\r
+<h2>SEE ALSO</h2>\r
+<div class="sectionbody">\r
+<p><a href="git-submodule.html">git-submodule(1)</a> <a href="git-config.html">git-config(1)</a></p>\r
+</div>\r
+<h2>DOCUMENTATION</h2>\r
+<div class="sectionbody">\r
+<p>Documentation by Lars Hjemli <hjemli@gmail.com></p>\r
+</div>\r
+<h2>GIT</h2>\r
+<div class="sectionbody">\r
+<p>Part of the <a href="git.html">git(7)</a> suite</p>\r
+</div>\r
+<div id="footer">\r
+<div id="footer-text">\r
+Last updated 16-Jun-2007 09:49:28 UTC\r
+</div>\r
+</div>\r
+</body>\r
+</html>\r
--- /dev/null
+gitmodules(5)
+=============
+
+NAME
+----
+gitmodules - defining submodule properties
+
+SYNOPSIS
+--------
+gitmodules
+
+
+DESCRIPTION
+-----------
+
+The `.gitmodules` file, located in the top-level directory of a git
+working tree, is a text file with a syntax matching the requirements
+of gitlink:git-config[1].
+
+The file contains one subsection per submodule, and the subsection value
+is the name of the submodule. Each submodule section also contains the
+following required keys:
+
+submodule.<name>.path::
+ Defines the path, relative to the top-level directory of the git
+ working tree, where the submodule is expected to be checked out.
+ The path name must not end with a `/`. All submodule paths must
+ be unique within the .gitmodules file.
+
+submodule.<name>.url::
+ Defines an url from where the submodule repository can be cloned.
+
+
+EXAMPLES
+--------
+
+Consider the following .gitmodules file:
+
+ [submodule "libfoo"]
+ path = include/foo
+ url = git://foo.com/git/lib.git
+
+ [submodule "libbar"]
+ path = include/bar
+ url = git://bar.com/git/lib.git
+
+
+This defines two submodules, `libfoo` and `libbar`. These are expected to
+be checked out in the paths 'include/foo' and 'include/bar', and for both
+submodules an url is specified which can be used for cloning the submodules.
+
+SEE ALSO
+--------
+gitlink:git-submodule[1] gitlink:git-config[1]
+
+DOCUMENTATION
+-------------
+Documentation by Lars Hjemli <hjemli@gmail.com>
+
+GIT
+---
+Part of the gitlink:git[7] suite
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:45 UTC\r
+Last updated 16-Jun-2007 09:49:32 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:44 UTC\r
+Last updated 16-Jun-2007 09:49:32 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:44 UTC\r
+Last updated 16-Jun-2007 09:49:31 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:45 UTC\r
+Last updated 16-Jun-2007 09:49:33 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:44 UTC\r
+Last updated 16-Jun-2007 09:49:31 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:41 UTC\r
+Last updated 16-Jun-2007 09:49:29 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 11-Jun-2007 01:21:27 UTC\r
+Last updated 16-Jun-2007 09:49:28 UTC\r
</div>\r
</div>\r
</body>\r
independently of the contents or the type of the object: all objects can
be validated by verifying that (a) their hashes match the content of the
file and (b) the object successfully inflates to a stream of bytes that
-forms a sequence of <ascii type without space> + <space> + <ascii decimal
-size> + <byte\0> + <binary object data>.
+forms a sequence of <ascii type without space> {plus} <space> {plus} <ascii decimal
+size> {plus} <byte\0> {plus} <binary object data>.
The structured objects can further have their structure and
connectivity to other objects verified. This is generally done with