Autogenerated HTML docs for v1.5.4.3-325-g6d21
authorJunio C Hamano <junio@hera.kernel.org>
Thu, 28 Feb 2008 00:27:44 +0000 (00:27 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Thu, 28 Feb 2008 00:27:44 +0000 (00:27 +0000)
28 files changed:
config.txt
diff-options.txt
git-branch.html
git-branch.txt
git-checkout.html
git-checkout.txt
git-clone.html
git-config.html
git-describe.html
git-describe.txt
git-diff-files.html
git-diff-index.html
git-diff-tree.html
git-diff.html
git-fetch.html
git-format-patch.html
git-format-patch.txt
git-log.html
git-pack-objects.html
git-pack-objects.txt
git-pull.html
git-push.html
git-rev-list.html
git-rev-list.txt
git-svn.html
git-svn.txt
rev-list-options.txt
urls.txt

index fb6dae0..4027726 100644 (file)
@@ -379,10 +379,14 @@ apply.whitespace::
 
 branch.autosetupmerge::
        Tells `git-branch` and `git-checkout` to setup new branches
-       so that linkgit:git-pull[1] will appropriately merge from that
-       remote branch.  Note that even if this option is not set,
+       so that linkgit:git-pull[1] will appropriately merge from the
+       starting point branch. Note that even if this option is not set,
        this behavior can be chosen per-branch using the `--track`
-       and `--no-track` options.  This option defaults to true.
+       and `--no-track` options. The valid settings are: `false` -- no
+       automatic setup is done; `true` -- automatic setup is done when the
+       starting point is a remote branch; `always` -- automatic setup is
+       done when the starting point is either a local branch or remote
+       branch. This option defaults to true.
 
 branch.<name>.remote::
        When in branch <name>, it tells `git fetch` which remote to fetch.
@@ -812,6 +816,8 @@ pack.threads::
        warning. This is meant to reduce packing time on multiprocessor
        machines. The required amount of memory for the delta search window
        is however multiplied by the number of threads.
+       Specifying 0 will cause git to auto-detect the number of CPU's
+       and set the number of threads accordingly.
 
 pack.indexVersion::
        Specify the default pack index version.  Valid values are 1 for
@@ -897,6 +903,17 @@ tar.umask::
        archiving user's umask will be used instead.  See umask(2) and
        linkgit:git-archive[1].
 
+url.<base>.insteadOf::
+       Any URL that starts with this value will be rewritten to
+       start, instead, with <base>. In cases where some site serves a
+       large number of repositories, and serves them with multiple
+       access methods, and some users need to use different access
+       methods, this feature allows people to specify any of the
+       equivalent URLs and have git automatically rewrite the URL to
+       the best alternative for the particular user, even for a
+       never-before-seen repository on the site.  When more than one
+       insteadOf strings match a given URL, the longest match is used.
+
 user.email::
        Your email address to be recorded in any newly created commits.
        Can be overridden by the 'GIT_AUTHOR_EMAIL', 'GIT_COMMITTER_EMAIL', and
index 8d35cbd..8dc5b00 100644 (file)
@@ -170,6 +170,14 @@ endif::git-format-patch[]
        Swap two inputs; that is, show differences from index or
        on-disk file to tree contents.
 
+--relative[=<path>]::
+       When run from a subdirectory of the project, it can be
+       told to exclude changes outside the directory and show
+       pathnames relative to it with this option.  When you are
+       not in a subdirectory (e.g. in a bare repository), you
+       can name which subdirectory to make the output relative
+       to by giving a <path> as an argument.
+
 --text::
        Treat all files as text.
 
index 227436d..6e1bc8b 100644 (file)
@@ -297,11 +297,10 @@ equal to that of the currently checked out branch.</p>
 working tree to it; use "git checkout &lt;newbranch&gt;" to switch to the\r
 new branch.</p>\r
 <p>When a local branch is started off a remote branch, git sets up the\r
-branch so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from that\r
-remote branch.  If this behavior is not desired, it is possible to\r
-disable it using the global <tt>branch.autosetupmerge</tt> configuration\r
-flag.  That setting can be overridden by using the <tt>--track</tt>\r
-and <tt>--no-track</tt> options.</p>\r
+branch so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from\r
+the remote branch. This behavior may be changed via the global\r
+<tt>branch.autosetupmerge</tt> configuration flag. That setting can be\r
+overridden by using the <tt>--track</tt> and <tt>--no-track</tt> options.</p>\r
 <p>With a <em>-m</em> or <em>-M</em> option, &lt;oldbranch&gt; will be renamed to &lt;newbranch&gt;.\r
 If &lt;oldbranch&gt; had a corresponding reflog, it is renamed to match\r
 &lt;newbranch&gt;, and a reflog entry is created to remember the branch\r
@@ -433,14 +432,16 @@ clean up all obsolete remote-tracking branches.</p>
 </dt>\r
 <dd>\r
 <p>\r
-        Set up configuration so that git-pull will automatically\r
-        retrieve data from the remote branch.  Use this if you always\r
-        pull from the same remote branch into the new branch, or if you\r
-        don't want to use "git pull &lt;repository&gt; &lt;refspec&gt;" explicitly.\r
-        This behavior is the default.  Set the\r
-        branch.autosetupmerge configuration variable to false if you\r
-        want git-checkout and git-branch to always behave as if\r
-        <em>--no-track</em> were given.\r
+        When creating a new branch, set up configuration so that git-pull\r
+        will automatically retrieve data from the start point, which must be\r
+        a branch. Use this if you always pull from the same upstream branch\r
+        into the new branch, and if you don't want to use "git pull\r
+        &lt;repository&gt; &lt;refspec&gt;" explicitly. This behavior is the default\r
+        when the start point is a remote branch. Set the\r
+        branch.autosetupmerge configuration variable to <tt>false</tt> if you want\r
+        git-checkout and git-branch to always behave as if <em>--no-track</em> were\r
+        given. Set it to <tt>always</tt> if you want this behavior when the\r
+        start-point is either a local or remote branch.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -448,10 +449,7 @@ clean up all obsolete remote-tracking branches.</p>
 </dt>\r
 <dd>\r
 <p>\r
-        When a branch is created off a remote branch,\r
-        set up configuration so that git-pull will not retrieve data\r
-        from the remote branch, ignoring the branch.autosetupmerge\r
-        configuration variable.\r
+        Ignore the branch.autosetupmerge configuration variable.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -566,7 +564,7 @@ a branch and check it out with a single command.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 12-Feb-2008 03:18:04 UTC\r
+Last updated 28-Feb-2008 00:25:37 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 7e8874a..6f07a17 100644 (file)
@@ -35,11 +35,10 @@ working tree to it; use "git checkout <newbranch>" to switch to the
 new branch.
 
 When a local branch is started off a remote branch, git sets up the
-branch so that linkgit:git-pull[1] will appropriately merge from that
-remote branch.  If this behavior is not desired, it is possible to
-disable it using the global `branch.autosetupmerge` configuration
-flag.  That setting can be overridden by using the `--track`
-and `--no-track` options.
+branch so that linkgit:git-pull[1] will appropriately merge from
+the remote branch. This behavior may be changed via the global
+`branch.autosetupmerge` configuration flag. That setting can be
+overridden by using the `--track` and `--no-track` options.
 
 With a '-m' or '-M' option, <oldbranch> will be renamed to <newbranch>.
 If <oldbranch> had a corresponding reflog, it is renamed to match
@@ -105,20 +104,19 @@ OPTIONS
        Display the full sha1s in output listing rather than abbreviating them.
 
 --track::
-       Set up configuration so that git-pull will automatically
-       retrieve data from the remote branch.  Use this if you always
-       pull from the same remote branch into the new branch, or if you
-       don't want to use "git pull <repository> <refspec>" explicitly.
-       This behavior is the default.  Set the
-       branch.autosetupmerge configuration variable to false if you
-       want git-checkout and git-branch to always behave as if
-       '--no-track' were given.
+       When creating a new branch, set up configuration so that git-pull
+       will automatically retrieve data from the start point, which must be
+       a branch. Use this if you always pull from the same upstream branch
+       into the new branch, and if you don't want to use "git pull
+       <repository> <refspec>" explicitly. This behavior is the default
+       when the start point is a remote branch. Set the
+       branch.autosetupmerge configuration variable to `false` if you want
+       git-checkout and git-branch to always behave as if '--no-track' were
+       given. Set it to `always` if you want this behavior when the
+       start-point is either a local or remote branch.
 
 --no-track::
-       When a branch is created off a remote branch,
-       set up configuration so that git-pull will not retrieve data
-       from the remote branch, ignoring the branch.autosetupmerge
-       configuration variable.
+       Ignore the branch.autosetupmerge configuration variable.
 
 <branchname>::
        The name of the branch to create or delete.
index 83420b0..e5a74dd 100644 (file)
@@ -330,15 +330,16 @@ working tree.</p>
 </dt>\r
 <dd>\r
 <p>\r
-        When -b is given and a branch is created off a remote branch,\r
-        set up configuration so that git-pull will automatically\r
-        retrieve data from the remote branch.  Use this if you always\r
-        pull from the same remote branch into the new branch, or if you\r
-        don't want to use "git pull &lt;repository&gt; &lt;refspec&gt;" explicitly.\r
-        This behavior is the default.  Set the\r
-        branch.autosetupmerge configuration variable to false if you\r
-        want git-checkout and git-branch to always behave as if\r
-        <em>--no-track</em> were given.\r
+        When creating a new branch, set up configuration so that git-pull\r
+        will automatically retrieve data from the start point, which must be\r
+        a branch. Use this if you always pull from the same upstream branch\r
+        into the new branch, and if you don't want to use "git pull\r
+        &lt;repository&gt; &lt;refspec&gt;" explicitly. This behavior is the default\r
+        when the start point is a remote branch. Set the\r
+        branch.autosetupmerge configuration variable to <tt>false</tt> if you want\r
+        git-checkout and git-branch to always behave as if <em>--no-track</em> were\r
+        given. Set it to <tt>always</tt> if you want this behavior when the\r
+        start-point is either a local or remote branch.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -346,10 +347,7 @@ working tree.</p>
 </dt>\r
 <dd>\r
 <p>\r
-        When -b is given and a branch is created off a remote branch,\r
-        set up configuration so that git-pull will not retrieve data\r
-        from the remote branch, ignoring the branch.autosetupmerge\r
-        configuration variable.\r
+        Ignore the branch.autosetupmerge configuration variable.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -541,7 +539,7 @@ $ git add frotz</tt></pre>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 12-Feb-2008 03:18:04 UTC\r
+Last updated 28-Feb-2008 00:25:37 UTC\r
 </div>\r
 </div>\r
 </body>\r
index b4cfa04..4014e72 100644 (file)
@@ -48,21 +48,19 @@ OPTIONS
        may restrict the characters allowed in a branch name.
 
 --track::
-       When -b is given and a branch is created off a remote branch,
-       set up configuration so that git-pull will automatically
-       retrieve data from the remote branch.  Use this if you always
-       pull from the same remote branch into the new branch, or if you
-       don't want to use "git pull <repository> <refspec>" explicitly.
-       This behavior is the default.  Set the
-       branch.autosetupmerge configuration variable to false if you
-       want git-checkout and git-branch to always behave as if
-       '--no-track' were given.
+       When creating a new branch, set up configuration so that git-pull
+       will automatically retrieve data from the start point, which must be
+       a branch. Use this if you always pull from the same upstream branch
+       into the new branch, and if you don't want to use "git pull
+       <repository> <refspec>" explicitly. This behavior is the default
+       when the start point is a remote branch. Set the
+       branch.autosetupmerge configuration variable to `false` if you want
+       git-checkout and git-branch to always behave as if '--no-track' were
+       given. Set it to `always` if you want this behavior when the
+       start-point is either a local or remote branch.
 
 --no-track::
-       When -b is given and a branch is created off a remote branch,
-       set up configuration so that git-pull will not retrieve data
-       from the remote branch, ignoring the branch.autosetupmerge
-       configuration variable.
+       Ignore the branch.autosetupmerge configuration variable.
 
 -l::
        Create the new branch's reflog.  This activates recording of
index 737769d..958f977 100644 (file)
@@ -573,6 +573,24 @@ file:///path/to/repo.git/
 </ul>\r
 </div></div>\r
 <p>They are equivalent, except the former implies --local option.</p>\r
+<p>If there are a large number of similarly-named remote repositories and\r
+you want to use a different format for them (such that the URLs you\r
+use will be rewritten into URLs that work), you can create a\r
+configuration section of the form:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "&lt;actual url base&gt;"]\r
+                insteadOf = &lt;other url base&gt;</tt></pre>\r
+</div></div>\r
+<p>For example, with this:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "git://git.host.xz/"]\r
+                insteadOf = host.xz:/path/to/\r
+                insteadOf = work:</tt></pre>\r
+</div></div>\r
+<p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be\r
+rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p>\r
 </div>\r
 <h2>Examples</h2>\r
 <div class="sectionbody">\r
@@ -646,7 +664,7 @@ Create a repository on the kernel.org machine that borrows from Linus
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 14-Feb-2008 00:51:07 UTC\r
+Last updated 28-Feb-2008 00:25:37 UTC\r
 </div>\r
 </div>\r
 </body>\r
index d380da1..c826e1a 100644 (file)
@@ -1204,10 +1204,14 @@ branch.autosetupmerge
 <dd>\r
 <p>\r
         Tells <tt>git-branch</tt> and <tt>git-checkout</tt> to setup new branches\r
-        so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from that\r
-        remote branch.  Note that even if this option is not set,\r
+        so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from the\r
+        starting point branch. Note that even if this option is not set,\r
         this behavior can be chosen per-branch using the <tt>--track</tt>\r
-        and <tt>--no-track</tt> options.  This option defaults to true.\r
+        and <tt>--no-track</tt> options. The valid settings are: <tt>false</tt> &#8212; no\r
+        automatic setup is done; <tt>true</tt> &#8212; automatic setup is done when the\r
+        starting point is a remote branch; <tt>always</tt> &#8212; automatic setup is\r
+        done when the starting point is either a local branch or remote\r
+        branch. This option defaults to true.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -2002,6 +2006,8 @@ pack.threads
         warning. This is meant to reduce packing time on multiprocessor\r
         machines. The required amount of memory for the delta search window\r
         is however multiplied by the number of threads.\r
+        Specifying 0 will cause git to auto-detect the number of CPU's\r
+        and set the number of threads accordingly.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -2175,6 +2181,22 @@ tar.umask
 </p>\r
 </dd>\r
 <dt>\r
+url.&lt;base&gt;.insteadOf\r
+</dt>\r
+<dd>\r
+<p>\r
+        Any URL that starts with this value will be rewritten to\r
+        start, instead, with &lt;base&gt;. In cases where some site serves a\r
+        large number of repositories, and serves them with multiple\r
+        access methods, and some users need to use different access\r
+        methods, this feature allows people to specify any of the\r
+        equivalent URLs and have git automatically rewrite the URL to\r
+        the best alternative for the particular user, even for a\r
+        never-before-seen repository on the site.  When more than one\r
+        insteadOf strings match a given URL, the longest match is used.\r
+</p>\r
+</dd>\r
+<dt>\r
 user.email\r
 </dt>\r
 <dd>\r
@@ -2286,7 +2308,7 @@ web.browser
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 25-Feb-2008 08:40:21 UTC\r
+Last updated 28-Feb-2008 00:25:38 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 7c33eea..6e851d7 100644 (file)
@@ -338,6 +338,16 @@ additional commits and the abbreviated object name of the commit.</p>
         candidates to describe the input committish consider\r
         up to &lt;n&gt; candidates.  Increasing &lt;n&gt; above 10 will take\r
         slightly longer but may produce a more accurate result.\r
+        An &lt;n&gt; of 0 will cause only exact matches to be output.\r
+</p>\r
+</dd>\r
+<dt>\r
+--exact-match\r
+</dt>\r
+<dd>\r
+<p>\r
+        Only output exact matches (a tag directly references the\r
+        supplied commit).  This is a synonym for --candidates=0.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -437,7 +447,7 @@ updated by Shawn Pearce &lt;spearce@spearce.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 12-Feb-2008 03:18:05 UTC\r
+Last updated 28-Feb-2008 00:25:38 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 1c3dfb4..fbb40a2 100644 (file)
@@ -45,6 +45,11 @@ OPTIONS
        candidates to describe the input committish consider
        up to <n> candidates.  Increasing <n> above 10 will take
        slightly longer but may produce a more accurate result.
+       An <n> of 0 will cause only exact matches to be output.
+
+--exact-match::
+       Only output exact matches (a tag directly references the
+       supplied commit).  This is a synonym for --candidates=0.
 
 --debug::
        Verbosely display information about the searching strategy
index 585729d..2e44b69 100644 (file)
@@ -601,6 +601,19 @@ same as "git-diff-index" and "git-diff-tree".</p>
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -1261,7 +1274,7 @@ the pathname, but if that is <tt>NUL</tt>, the record will show two paths.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:13 UTC\r
+Last updated 28-Feb-2008 00:25:38 UTC\r
 </div>\r
 </div>\r
 </body>\r
index c333894..37b68cb 100644 (file)
@@ -602,6 +602,19 @@ entries in the index are compared.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -1343,7 +1356,7 @@ always have the special all-zero sha1.</td>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:13 UTC\r
+Last updated 28-Feb-2008 00:25:39 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 09afd55..053b7db 100644 (file)
@@ -604,6 +604,19 @@ git-diff-tree(1) Manual Page
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -1731,7 +1744,7 @@ the pathname, but if that is <tt>NUL</tt>, the record will show two paths.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:15 UTC\r
+Last updated 28-Feb-2008 00:25:39 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 9f1a128..8983b85 100644 (file)
@@ -680,6 +680,19 @@ and the range notations ("&lt;commit&gt;..&lt;commit&gt;" and
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -1458,7 +1471,7 @@ Output diff in reverse.
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:15 UTC\r
+Last updated 28-Feb-2008 00:25:41 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 5b7174a..a9c3438 100644 (file)
@@ -594,6 +594,24 @@ file:///path/to/repo.git/
 </div></div>\r
 <p>They are mostly equivalent, except when cloning.  See\r
 <a href="git-clone.html">git-clone(1)</a> for details.</p>\r
+<p>If there are a large number of similarly-named remote repositories and\r
+you want to use a different format for them (such that the URLs you\r
+use will be rewritten into URLs that work), you can create a\r
+configuration section of the form:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "&lt;actual url base&gt;"]\r
+                insteadOf = &lt;other url base&gt;</tt></pre>\r
+</div></div>\r
+<p>For example, with this:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "git://git.host.xz/"]\r
+                insteadOf = host.xz:/path/to/\r
+                insteadOf = work:</tt></pre>\r
+</div></div>\r
+<p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be\r
+rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p>\r
 </div>\r
 <h2>REMOTES</h2>\r
 <div class="sectionbody">\r
@@ -663,7 +681,7 @@ Junio C Hamano &lt;junkio@cox.net&gt;</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 27-Jan-2008 08:23:28 UTC\r
+Last updated 28-Feb-2008 00:25:41 UTC\r
 </div>\r
 </div>\r
 </body>\r
index cf1875e..e149dd0 100644 (file)
@@ -281,6 +281,8 @@ git-format-patch(1) Manual Page
                    [--in-reply-to=Message-Id] [--suffix=.&lt;sfx&gt;]\r
                    [--ignore-if-in-upstream]\r
                    [--subject-prefix=Subject-Prefix]\r
+                   [--cc=&lt;email&gt;]\r
+                   [--cover-letter]\r
                    [ &lt;since&gt; | &lt;revision range&gt; ]</div></div>\r
 </div>\r
 <h2>DESCRIPTION</h2>\r
@@ -648,6 +650,19 @@ reference.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -913,6 +928,25 @@ reference.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--cc=&lt;email&gt;\r
+</dt>\r
+<dd>\r
+<p>\r
+        Add a "Cc:" header to the email headers. This is in addition\r
+        to any configured headers, and may be used multiple times.\r
+</p>\r
+</dd>\r
+<dt>\r
+--cover-letter\r
+</dt>\r
+<dd>\r
+<p>\r
+        Generate a cover letter template.  You still have to fill in\r
+        a description, but the shortlog and the diffstat will be\r
+        generated for you.\r
+</p>\r
+</dd>\r
+<dt>\r
 --suffix=.&lt;sfx&gt;\r
 </dt>\r
 <dd>\r
@@ -1017,7 +1051,7 @@ git-format-patch -3
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:21 UTC\r
+Last updated 28-Feb-2008 00:25:42 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 651efe6..b5207b7 100644 (file)
@@ -10,13 +10,15 @@ SYNOPSIS
 --------
 [verse]
 'git-format-patch' [-k] [-o <dir> | --stdout] [--thread]
-                   [--attach[=<boundary>] | --inline[=<boundary>]]
-                   [-s | --signoff] [<common diff options>]
-                   [-n | --numbered | -N | --no-numbered]
-                   [--start-number <n>] [--numbered-files]
-                   [--in-reply-to=Message-Id] [--suffix=.<sfx>]
-                   [--ignore-if-in-upstream]
-                   [--subject-prefix=Subject-Prefix]
+                  [--attach[=<boundary>] | --inline[=<boundary>]]
+                  [-s | --signoff] [<common diff options>]
+                  [-n | --numbered | -N | --no-numbered]
+                  [--start-number <n>] [--numbered-files]
+                  [--in-reply-to=Message-Id] [--suffix=.<sfx>]
+                  [--ignore-if-in-upstream]
+                  [--subject-prefix=Subject-Prefix]
+                  [--cc=<email>]
+                  [--cover-letter]
                   [ <since> | <revision range> ]
 
 DESCRIPTION
@@ -135,6 +137,15 @@ include::diff-options.txt[]
        allows for useful naming of a patch series, and can be
        combined with the --numbered option.
 
+--cc=<email>::
+       Add a "Cc:" header to the email headers. This is in addition
+       to any configured headers, and may be used multiple times.
+
+--cover-letter::
+       Generate a cover letter template.  You still have to fill in
+       a description, but the shortlog and the diffstat will be
+       generated for you.
+
 --suffix=.<sfx>::
        Instead of using `.patch` as the suffix for generated
        filenames, use specified suffix.  A common alternative is
index ab8cdb1..0c3eba7 100644 (file)
@@ -602,6 +602,19 @@ each commit introduces are shown.</p>
 </p>\r
 </dd>\r
 <dt>\r
+--relative[=&lt;path&gt;]\r
+</dt>\r
+<dd>\r
+<p>\r
+        When run from a subdirectory of the project, it can be\r
+        told to exclude changes outside the directory and show\r
+        pathnames relative to it with this option.  When you are\r
+        not in a subdirectory (e.g. in a bare repository), you\r
+        can name which subdirectory to make the output relative\r
+        to by giving a &lt;path&gt; as an argument.\r
+</p>\r
+</dd>\r
+<dt>\r
 --text\r
 </dt>\r
 <dd>\r
@@ -1043,6 +1056,15 @@ limiting may be applied.</p>
 </p>\r
 </dd>\r
 <dt>\r
+-F, --fixed-strings\r
+</dt>\r
+<dd>\r
+<p>\r
+        Consider the limiting patterns to be fixed strings (don't interpret\r
+        pattern as a regular expression).\r
+</p>\r
+</dd>\r
+<dt>\r
 --remove-empty\r
 </dt>\r
 <dd>\r
@@ -1894,7 +1916,7 @@ reversible operation.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 19-Jan-2008 08:01:34 UTC\r
+Last updated 28-Feb-2008 00:25:42 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 7d55249..c497960 100644 (file)
@@ -530,6 +530,8 @@ base-name
         This is meant to reduce packing time on multiprocessor machines.\r
         The required amount of memory for the delta search window is\r
         however multiplied by the number of threads.\r
+        Specifying 0 will cause git to auto-detect the number of CPU's\r
+        and set the number of threads accordingly.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -564,7 +566,7 @@ base-name
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 10-Feb-2008 10:47:42 UTC\r
+Last updated 28-Feb-2008 00:25:42 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 8353be1..5c1bd3b 100644 (file)
@@ -177,6 +177,8 @@ base-name::
        This is meant to reduce packing time on multiprocessor machines.
        The required amount of memory for the delta search window is
        however multiplied by the number of threads.
+       Specifying 0 will cause git to auto-detect the number of CPU's
+       and set the number of threads accordingly.
 
 --index-version=<version>[,<offset>]::
        This is intended to be used by the test suite only. It allows
index 0cc7084..e6d2f82 100644 (file)
@@ -705,6 +705,24 @@ file:///path/to/repo.git/
 </div></div>\r
 <p>They are mostly equivalent, except when cloning.  See\r
 <a href="git-clone.html">git-clone(1)</a> for details.</p>\r
+<p>If there are a large number of similarly-named remote repositories and\r
+you want to use a different format for them (such that the URLs you\r
+use will be rewritten into URLs that work), you can create a\r
+configuration section of the form:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "&lt;actual url base&gt;"]\r
+                insteadOf = &lt;other url base&gt;</tt></pre>\r
+</div></div>\r
+<p>For example, with this:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "git://git.host.xz/"]\r
+                insteadOf = host.xz:/path/to/\r
+                insteadOf = work:</tt></pre>\r
+</div></div>\r
+<p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be\r
+rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p>\r
 </div>\r
 <h2>REMOTES</h2>\r
 <div class="sectionbody">\r
@@ -973,7 +991,7 @@ Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 20-Feb-2008 10:44:09 UTC\r
+Last updated 28-Feb-2008 00:25:43 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 6ada41e..0f3679b 100644 (file)
@@ -522,6 +522,24 @@ file:///path/to/repo.git/
 </div></div>\r
 <p>They are mostly equivalent, except when cloning.  See\r
 <a href="git-clone.html">git-clone(1)</a> for details.</p>\r
+<p>If there are a large number of similarly-named remote repositories and\r
+you want to use a different format for them (such that the URLs you\r
+use will be rewritten into URLs that work), you can create a\r
+configuration section of the form:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "&lt;actual url base&gt;"]\r
+                insteadOf = &lt;other url base&gt;</tt></pre>\r
+</div></div>\r
+<p>For example, with this:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        [url "git://git.host.xz/"]\r
+                insteadOf = host.xz:/path/to/\r
+                insteadOf = work:</tt></pre>\r
+</div></div>\r
+<p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be\r
+rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p>\r
 </div>\r
 <h2>REMOTES</h2>\r
 <div class="sectionbody">\r
@@ -709,7 +727,7 @@ by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 20-Feb-2008 10:44:09 UTC\r
+Last updated 28-Feb-2008 00:25:43 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 0173f66..bf709ac 100644 (file)
@@ -295,6 +295,7 @@ git-rev-list(1) Manual Page
              [ --(author|committer|grep)=&lt;pattern&gt; ]\r
              [ --regexp-ignore-case | \-i ]\r
              [ --extended-regexp | \-E ]\r
+             [ --fixed-strings | \-F ]\r
              [ --date={local|relative|default|iso|rfc|short} ]\r
              [ [--objects | --objects-edge] [ --unpacked ] ]\r
              [ --pretty | --header ]\r
@@ -596,6 +597,15 @@ limiting may be applied.</p>
 </p>\r
 </dd>\r
 <dt>\r
+-F, --fixed-strings\r
+</dt>\r
+<dd>\r
+<p>\r
+        Consider the limiting patterns to be fixed strings (don't interpret\r
+        pattern as a regular expression).\r
+</p>\r
+</dd>\r
+<dt>\r
 --remove-empty\r
 </dt>\r
 <dd>\r
@@ -1191,7 +1201,7 @@ and the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 19-Jan-2008 08:01:34 UTC\r
+Last updated 28-Feb-2008 00:25:44 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 5b96eab..a8d489f 100644 (file)
@@ -31,6 +31,7 @@ SYNOPSIS
             [ \--(author|committer|grep)=<pattern> ]
             [ \--regexp-ignore-case | \-i ]
             [ \--extended-regexp | \-E ]
+            [ \--fixed-strings | \-F ]
             [ \--date={local|relative|default|iso|rfc|short} ]
             [ [\--objects | \--objects-edge] [ \--unpacked ] ]
             [ \--pretty | \--header ]
index dca6f71..c5b2af3 100644 (file)
@@ -553,6 +553,16 @@ and have no uncommitted changes.</p>
 </p>\r
 </dd>\r
 </dl>\r
+<div class="admonitionblock">\r
+<table><tr>\r
+<td class="icon">\r
+<div class="title">Note</div>\r
+</td>\r
+<td class="content">SVN itself only stores times in UTC and nothing else. The regular svn\r
+client converts the UTC time to the local time (or based on the TZ=\r
+environment). This command has the same behaviour.</td>\r
+</tr></table>\r
+</div>\r
 <p>Any other arguments are passed directly to `git log'</p>\r
 </dd>\r
 <dt>\r
@@ -1085,7 +1095,7 @@ should be manually entered with a text-editor or using
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 12-Feb-2008 03:18:07 UTC\r
+Last updated 28-Feb-2008 00:25:44 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 340f1be..bec9acc 100644 (file)
@@ -159,6 +159,10 @@ New features:
        our version of --pretty=oneline
 --
 +
+NOTE: SVN itself only stores times in UTC and nothing else. The regular svn
+client converts the UTC time to the local time (or based on the TZ=
+environment). This command has the same behaviour.
++
 Any other arguments are passed directly to `git log'
 
 'blame'::
index a8138e2..259072c 100644 (file)
@@ -153,6 +153,11 @@ limiting may be applied.
        Consider the limiting patterns to be extended regular expressions
        instead of the default basic regular expressions.
 
+-F, --fixed-strings::
+
+       Consider the limiting patterns to be fixed strings (don't interpret
+       pattern as a regular expression).
+
 --remove-empty::
 
        Stop when a given path disappears from the tree.
index 81ac17f..fa34c67 100644 (file)
--- a/urls.txt
+++ b/urls.txt
@@ -44,3 +44,26 @@ endif::git-clone[]
 ifdef::git-clone[]
 They are equivalent, except the former implies --local option.
 endif::git-clone[]
+
+
+If there are a large number of similarly-named remote repositories and
+you want to use a different format for them (such that the URLs you
+use will be rewritten into URLs that work), you can create a
+configuration section of the form:
+
+------------
+       [url "<actual url base>"]
+               insteadOf = <other url base>
+------------
+
+For example, with this:
+
+------------
+       [url "git://git.host.xz/"]
+               insteadOf = host.xz:/path/to/
+               insteadOf = work:
+------------
+
+a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be
+rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".
+