Autogenerated HTML docs for v1.5.2.1-111-gc94b
authorJunio C Hamano <junio@hera.kernel.org>
Sun, 3 Jun 2007 08:40:14 +0000 (08:40 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Sun, 3 Jun 2007 08:40:14 +0000 (08:40 +0000)
16 files changed:
RelNotes-1.5.2.1.txt [new file with mode: 0644]
RelNotes-1.5.3.txt [new file with mode: 0644]
cmds-ancillaryinterrogators.txt
cmds-mainporcelain.txt
cmds-purehelpers.txt
git-am.html
git-am.txt
git-applymbox.txt [deleted file]
git-applypatch.txt [deleted file]
git-mailinfo.html
git-mailinfo.txt
git-submodule.html [new file with mode: 0644]
git-submodule.txt [new file with mode: 0644]
git.html
hooks.html
hooks.txt

diff --git a/RelNotes-1.5.2.1.txt b/RelNotes-1.5.2.1.txt
new file mode 100644 (file)
index 0000000..ebf20e2
--- /dev/null
@@ -0,0 +1,53 @@
+GIT v1.5.2.1 Release Notes
+==========================
+
+Fixes since v1.5.2
+------------------
+
+* Bugfixes
+
+  - Temporary files that are used when invoking external diff
+    programs did not tolerate a long TMPDIR.
+
+  - git-daemon did not notice when it could not write into its
+    pid file.
+
+  - git-status did not honor core.excludesFile configuration like
+    git-add did.
+
+  - git-annotate did not work from a subdirectory while
+    git-blame did.
+
+  - git-cvsserver should have disabled access to a repository
+    with "gitcvs.pserver.enabled = false" set even when
+    "gitcvs.enabled = true" was set at the same time.  It
+    didn't.
+
+  - git-cvsimport did not work correctly in a repository with
+    its branch heads were packed with pack-refs.
+
+  - ident unexpansion to squash "$Id: xxx $" that is in the
+    repository copy removed incorrect number of bytes.
+
+  - git-svn misbehaved when the subversion repository did not
+    provide MD5 checksums for files.
+
+  - git rebase (and git am) misbehaved on commits that have '\n'
+    (literally backslash and en, not a linefeed) in the title.
+
+  - code to decode base85 used in binary patches had one error
+    return codepath wrong.
+
+  - RFC2047 Q encoding output by git-format-patch used '_' for a
+    space, which is not understood by some programs.  It uses =20
+    which is safer.
+
+  - git-fastimport --import-marks was broken; fixed.
+
+  - A lot of documentation updates, clarifications and fixes.
+
+--
+exec >/var/tmp/1
+O=v1.5.2-65-g996e2d6
+echo O=`git describe refs/heads/maint`
+git shortlog --no-merges $O..refs/heads/maint
diff --git a/RelNotes-1.5.3.txt b/RelNotes-1.5.3.txt
new file mode 100644 (file)
index 0000000..d111661
--- /dev/null
@@ -0,0 +1,109 @@
+GIT v1.5.3 Release Notes (draft)
+========================
+
+Updates since v1.5.2
+--------------------
+
+* An initial interation of Porcelain level superproject support
+  started to take shape.
+
+* Thee are a handful pack-objects changes to help you cope better with
+  repositories with pathologically large blobs in them.
+
+* New commands and options.
+
+  - "git-submodule" command helps you manage the projects from
+    the superproject that contain them.
+
+  - In addition to core.compression configuration option,
+    core.loosecompression and pack.compression options can
+    independently tweak zlib compression levels used for loose
+    and packed objects.
+
+  - "git-ls-tree -l" shows size of blobs pointed at by the
+    tree entries, similar to "/bin/ls -l".
+
+  - "git-rev-list" learned --regexp-ignore-case and
+    --extended-regexp options to tweak its matching logic used
+    for --grep fitering.
+
+  - "git-describe --contains" is a handier way to call more
+    obscure command "git-name-rev --tags".
+
+  - "git gc --aggressive" tells the command to spend more cycles
+    to optimize the repository harder.
+
+  - "git repack" can be told to split resulting packs to avoid
+    exceeding limit specified with "--max-pack-size".
+
+* Updated behavior of existing commands.
+
+  - "git push" pretends that you immediately fetched back from
+    the remote by updating corresponding remote tracking
+    branches if you have any.
+
+  - The diffstat given after a merge (or a pull) honors the
+    color.diff configuration.
+
+  - "git-apply --whitespace=strip" removes blank lines added at
+    the end of the file.
+
+  - fetch over git native protocols with -v shows connection
+    status, and the IP address of the other end, to help
+    diagnosing problems.
+
+  - core.legacyheaders is no more, although we still can read
+    objects created in a new loose object format.
+
+  - "git-mailsplit" (hence "git-am") can read from Maildir
+    formatted mailboxes.
+
+  - "git cvsserver" does not barf upon seeing "cvs login"
+    request.
+
+  - "pack-objects" honors "delta" attribute set in
+    .gitattributes.  It does not attempt to deltify blobs that
+    come from paths with delta attribute set to false.
+
+  - new-workdir script (in contrib) can now be used with a bare
+    repository.
+
+
+* Builds
+
+  -
+
+* Performance Tweaks
+
+  - git-pack-objects avoids re-deltification cost by caching
+    small enough delta results it creates while looking for the
+    best delta candidates.
+
+  - diff-delta code that is used for packing has been improved
+    to work better on big files.
+
+  - when there are more than one pack files in the repository,
+    the runtime used to try finding an object always from the
+    newest packfile; it now tries the same packfile as we found
+    the object requested the last time, which exploits the
+    locality of references.
+
+Fixes since v1.5.2
+------------------
+
+All of the fixes in v1.5.2 maintenance series are included in
+this release, unless otherwise noted.
+
+* Bugfixes
+
+  - ....  This has not
+    been backported to 1.5.2.x series, as it is rather an
+    intrusive change.
+
+
+--
+exec >/var/tmp/1
+O=v1.5.2-45-ged82edc
+O=v1.5.2-172-g1a8b769
+echo O=`git describe refs/heads/master`
+git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint
index b09fdfa24b067ed0c170e92424bde5a1c168f1ad..5a52eabdd478abdb909f0b5555a0416da800b5d5 100644 (file)
@@ -1,9 +1,6 @@
 gitlink:git-annotate[1]::
        Annotate file lines with commit info.
 
-gitlink:git-applymbox[1]::
-       Apply a series of patches in a mailbox.
-
 gitlink:git-blame[1]::
        Show what revision and author last modified each line of a file.
 
index f01571b7123d6ad9d47d1aa841c90b2dfb9ad5b6..a2a5eb354e638e74b6dff2707b25e6b4cf87c186 100644 (file)
@@ -91,6 +91,9 @@ gitlink:git-show[1]::
 gitlink:git-status[1]::
        Show the working tree status.
 
+gitlink:git-submodule[1]::
+       Initialize, update or inspect submodules.
+
 gitlink:git-tag[1]::
        Create, list, delete or verify a tag object signed with GPG.
 
index 05a2f38b91ef955a82b01ceb35d06c133ecf1293..9880388deb49d3121f897f951f8de7205b596209 100644 (file)
@@ -1,6 +1,3 @@
-gitlink:git-applypatch[1]::
-       Apply one patch extracted from an e-mail.
-
 gitlink:git-check-attr[1]::
        Display gitattributes information..
 
index c96c821ef01fe8498a8aa1cbae9ae3b90a74cf31..3f4902ff0f20564d2603e0df42c2d14b3b350855 100644 (file)
@@ -470,8 +470,7 @@ a line that begins with "Index: "
 is terminated before the first occurrence of such a line.</p>\r
 <p>When initially invoking it, you give it names of the mailboxes\r
 to crunch.  Upon seeing the first patch that does not apply, it\r
-aborts in the middle, just like <em>git-applymbox</em> does.  You can\r
-recover from this in one of two ways:</p>\r
+aborts in the middle,.  You can recover from this in one of two ways:</p>\r
 <ol>\r
 <li>\r
 <p>\r
@@ -494,7 +493,7 @@ names.</p>
 </div>\r
 <h2>SEE ALSO</h2>\r
 <div class="sectionbody">\r
-<p><a href="git-applymbox.html">git-applymbox(1)</a>, <a href="git-applypatch.html">git-applypatch(1)</a>, <a href="git-apply.html">git-apply(1)</a>.</p>\r
+<p><a href="git-apply.html">git-apply(1)</a>.</p>\r
 </div>\r
 <h2>Author</h2>\r
 <div class="sectionbody">\r
@@ -510,7 +509,7 @@ names.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 02-Jun-2007 21:09:21 UTC\r
+Last updated 03-Jun-2007 08:39:37 UTC\r
 </div>\r
 </div>\r
 </body>\r
index f78e5dc28d7a641a2c6db93ba74d95e45d175dd0..f3387f5d09959c1e94cb2e140d5ccc617b45ebb1 100644 (file)
@@ -127,8 +127,7 @@ is terminated before the first occurrence of such a line.
 
 When initially invoking it, you give it names of the mailboxes
 to crunch.  Upon seeing the first patch that does not apply, it
-aborts in the middle, just like 'git-applymbox' does.  You can
-recover from this in one of two ways:
+aborts in the middle,.  You can recover from this in one of two ways:
 
 . skip the current patch by re-running the command with '--skip'
   option.
@@ -145,7 +144,7 @@ names.
 
 SEE ALSO
 --------
-gitlink:git-applymbox[1], gitlink:git-applypatch[1], gitlink:git-apply[1].
+gitlink:git-apply[1].
 
 
 Author
diff --git a/git-applymbox.txt b/git-applymbox.txt
deleted file mode 100644 (file)
index ea919ba..0000000
+++ /dev/null
@@ -1,98 +0,0 @@
-git-applymbox(1)
-================
-
-NAME
-----
-git-applymbox - Apply a series of patches in a mailbox
-
-
-SYNOPSIS
---------
-'git-applymbox' [-u] [-k] [-q] [-m] ( -c .dotest/<num> | <mbox> ) [ <signoff> ]
-
-DESCRIPTION
------------
-Splits mail messages in a mailbox into commit log message,
-authorship information and patches, and applies them to the
-current branch.
-
-
-OPTIONS
--------
--q::
-       Apply patches interactively.  The user will be given
-       opportunity to edit the log message and the patch before
-       attempting to apply it.
-
--k::
-       Usually the program 'cleans up' the Subject: header line
-       to extract the title line for the commit log message,
-       among which (1) remove 'Re:' or 're:', (2) leading
-       whitespaces, (3) '[' up to ']', typically '[PATCH]', and
-       then prepends "[PATCH] ".  This flag forbids this
-       munging, and is most useful when used to read back 'git
-       format-patch -k' output.
-
--m::
-       Patches are applied with `git-apply` command, and unless
-       it cleanly applies without fuzz, the processing fails.
-       With this flag, if a tree that the patch applies cleanly
-       is found in a repository, the patch is applied to the
-       tree and then a 3-way merge between the resulting tree
-       and the current tree.
-
--u::
-       Pass `-u` flag to `git-mailinfo` (see gitlink:git-mailinfo[1]).
-       The proposed commit log message taken from the e-mail
-       are re-coded into UTF-8 encoding (configuration variable
-       `i18n.commitencoding` can be used to specify project's
-       preferred encoding if it is not UTF-8).  This used to be
-       optional but now it is the default.
-+
-Note that the patch is always used as-is without charset
-conversion, even with this flag.
-
--n::
-       Pass `-n` flag to `git-mailinfo` (see
-       gitlink:git-mailinfo[1]).
-
--c .dotest/<num>::
-       When the patch contained in an e-mail does not cleanly
-       apply, the command exits with an error message. The
-       patch and extracted message are found in .dotest/, and
-       you could re-run 'git applymbox' with '-c .dotest/<num>'
-       flag to restart the process after inspecting and fixing
-       them.
-
-<mbox>::
-       The name of the file that contains the e-mail messages
-       with patches.  This file should be in the UNIX mailbox
-       format.  See 'SubmittingPatches' document to learn about
-       the formatting convention for e-mail submission.
-
-<signoff>::
-       The name of the file that contains your "Signed-off-by"
-       line.  See 'SubmittingPatches' document to learn what
-       "Signed-off-by" line means.  You can also just say
-       'yes', 'true', 'me', or 'please' to use an automatically
-       generated "Signed-off-by" line based on your committer
-       identity.
-
-
-SEE ALSO
---------
-gitlink:git-am[1], gitlink:git-applypatch[1].
-
-
-Author
-------
-Written by Linus Torvalds <torvalds@osdl.org>
-
-Documentation
---------------
-Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
-
-GIT
----
-Part of the gitlink:git[7] suite
-
diff --git a/git-applypatch.txt b/git-applypatch.txt
deleted file mode 100644 (file)
index 451434a..0000000
+++ /dev/null
@@ -1,53 +0,0 @@
-git-applypatch(1)
-=================
-
-NAME
-----
-git-applypatch - Apply one patch extracted from an e-mail
-
-
-SYNOPSIS
---------
-'git-applypatch' <msg> <patch> <info> [<signoff>]
-
-DESCRIPTION
------------
-This is usually not what an end user wants to run directly.  See
-gitlink:git-am[1] instead.
-
-Takes three files <msg>, <patch>, and <info> prepared from an
-e-mail message by 'git-mailinfo', and creates a commit.  It is
-usually not necessary to use this command directly.
-
-This command can run `applypatch-msg`, `pre-applypatch`, and
-`post-applypatch` hooks.  See link:hooks.html[hooks] for more
-information.
-
-
-OPTIONS
--------
-<msg>::
-       Commit log message (sans the first line, which comes
-       from e-mail Subject stored in <info>).
-
-<patch>::
-       The patch to apply.
-
-<info>::
-       Author and subject information extracted from e-mail,
-       used on "author" line and as the first line of the
-       commit log message.
-
-
-Author
-------
-Written by Linus Torvalds <torvalds@osdl.org>
-
-Documentation
---------------
-Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
-
-GIT
----
-Part of the gitlink:git[7] suite
-
index f74ee53ff86b36608f299c1047308dfd4a5a9c84..b896aded8f3bd368bdf2d85d09b8023187fd9c38 100644 (file)
@@ -279,7 +279,7 @@ git-mailinfo(1) Manual Page
 <p>Reading a single e-mail message from the standard input, and\r
 writes the commit log message in &lt;msg&gt; file, and the patches in\r
 &lt;patch&gt; file.  The author name, e-mail and e-mail subject are\r
-written out to the standard output to be used by git-applypatch\r
+written out to the standard output to be used by git-am\r
 to create a commit.  It is usually not necessary to use this\r
 command directly.  See <a href="git-am.html">git-am(1)</a> instead.</p>\r
 </div>\r
@@ -357,7 +357,7 @@ Junio C Hamano &lt;junkio@cox.net&gt;</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 02-Jun-2007 21:09:46 UTC\r
+Last updated 03-Jun-2007 08:39:36 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 8eadcebfcf5c26c599cde0d939d1046de69f2335..16956951dd122698f7602b78c91be999348b61e4 100644 (file)
@@ -16,7 +16,7 @@ DESCRIPTION
 Reading a single e-mail message from the standard input, and
 writes the commit log message in <msg> file, and the patches in
 <patch> file.  The author name, e-mail and e-mail subject are
-written out to the standard output to be used by git-applypatch
+written out to the standard output to be used by git-am
 to create a commit.  It is usually not necessary to use this
 command directly.  See gitlink:git-am[1] instead.
 
diff --git a/git-submodule.html b/git-submodule.html
new file mode 100644 (file)
index 0000000..e28c907
--- /dev/null
@@ -0,0 +1,370 @@
+<!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>git-submodule(1)</title>\r
+</head>\r
+<body>\r
+<div id="header">\r
+<h1>\r
+git-submodule(1) Manual Page\r
+</h1>\r
+<h2>NAME</h2>\r
+<div class="sectionbody">\r
+<p>git-submodule -\r
+   Initialize, update or inspect submodules\r
+</p>\r
+</div>\r
+</div>\r
+<h2>SYNOPSIS</h2>\r
+<div class="sectionbody">\r
+<p><em>git-submodule</em> [--quiet] [--cached] [status|init|update] [--] [&lt;path&gt;&#8230;]</p>\r
+</div>\r
+<h2>COMMANDS</h2>\r
+<div class="sectionbody">\r
+<dl>\r
+<dt>\r
+status\r
+</dt>\r
+<dd>\r
+<p>\r
+        Show the status of the submodules. This will print the SHA-1 of the\r
+        currently checked out commit for each submodule, along with the\r
+        submodule path and the output of <a href="git-describe.html">git-describe(1)</a> for the\r
+        SHA-1. Each SHA-1 will be prefixed with <tt>-</tt> if the submodule is not\r
+        initialized and <tt>+</tt> if the currently checked out submodule commit\r
+        does not match the SHA-1 found in the index of the containing\r
+        repository. This command is the default command for git-submodule.\r
+</p>\r
+</dd>\r
+<dt>\r
+init\r
+</dt>\r
+<dd>\r
+<p>\r
+        Initialize the submodules, i.e. clone the git repositories specified\r
+        in the .gitmodules file and checkout the submodule commits specified\r
+        in the index of the containing repository. This will make the\r
+        submodules HEAD be detached.\r
+</p>\r
+</dd>\r
+<dt>\r
+update\r
+</dt>\r
+<dd>\r
+<p>\r
+        Update the initialized submodules, i.e. checkout the submodule commits\r
+        specified in the index of the containing repository. This will make\r
+        the submodules HEAD be detached.\r
+</p>\r
+</dd>\r
+</dl>\r
+</div>\r
+<h2>OPTIONS</h2>\r
+<div class="sectionbody">\r
+<dl>\r
+<dt>\r
+-q, --quiet\r
+</dt>\r
+<dd>\r
+<p>\r
+        Only print error messages.\r
+</p>\r
+</dd>\r
+<dt>\r
+--cached\r
+</dt>\r
+<dd>\r
+<p>\r
+        Display the SHA-1 stored in the index, not the SHA-1 of the currently\r
+        checked out submodule commit. This option is only valid for the\r
+        status command.\r
+</p>\r
+</dd>\r
+<dt>\r
+&lt;path&gt;\r
+</dt>\r
+<dd>\r
+<p>\r
+        Path to submodule(s). When specified this will restrict the command\r
+        to only operate on the submodules found at the specified paths.\r
+</p>\r
+</dd>\r
+</dl>\r
+</div>\r
+<h2>FILES</h2>\r
+<div class="sectionbody">\r
+<p>When cloning submodules, a .gitmodules file in the top-level directory\r
+of the containing repository is used to find the url of each submodule.\r
+This file should be formatted in the same way as $GIR_DIR/config. The key\r
+to each submodule url is "module.$path.url".</p>\r
+</div>\r
+<h2>AUTHOR</h2>\r
+<div class="sectionbody">\r
+<p>Written by Lars Hjemli &lt;hjemli@gmail.com&gt;</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 03-Jun-2007 08:39:37 UTC\r
+</div>\r
+</div>\r
+</body>\r
+</html>\r
diff --git a/git-submodule.txt b/git-submodule.txt
new file mode 100644 (file)
index 0000000..cb0424f
--- /dev/null
@@ -0,0 +1,65 @@
+git-submodule(1)
+================
+
+NAME
+----
+git-submodule - Initialize, update or inspect submodules
+
+
+SYNOPSIS
+--------
+'git-submodule' [--quiet] [--cached] [status|init|update] [--] [<path>...]
+
+
+COMMANDS
+--------
+status::
+       Show the status of the submodules. This will print the SHA-1 of the
+       currently checked out commit for each submodule, along with the
+       submodule path and the output of gitlink:git-describe[1] for the
+       SHA-1. Each SHA-1 will be prefixed with `-` if the submodule is not
+       initialized and `+` if the currently checked out submodule commit
+       does not match the SHA-1 found in the index of the containing
+       repository. This command is the default command for git-submodule.
+
+init::
+       Initialize the submodules, i.e. clone the git repositories specified
+       in the .gitmodules file and checkout the submodule commits specified
+       in the index of the containing repository. This will make the
+       submodules HEAD be detached.
+
+update::
+       Update the initialized submodules, i.e. checkout the submodule commits
+       specified in the index of the containing repository. This will make
+       the submodules HEAD be detached.
+
+
+OPTIONS
+-------
+-q, --quiet::
+       Only print error messages.
+
+--cached::
+       Display the SHA-1 stored in the index, not the SHA-1 of the currently
+       checked out submodule commit. This option is only valid for the
+       status command.
+
+<path>::
+       Path to submodule(s). When specified this will restrict the command
+       to only operate on the submodules found at the specified paths.
+
+FILES
+-----
+When cloning submodules, a .gitmodules file in the top-level directory
+of the containing repository is used to find the url of each submodule.
+This file should be formatted in the same way as $GIR_DIR/config. The key
+to each submodule url is "module.$path.url".
+
+
+AUTHOR
+------
+Written by Lars Hjemli <hjemli@gmail.com>
+
+GIT
+---
+Part of the gitlink:git[7] suite
index 057b7523fbeb38c54c48c77d874ac4b48393b637..58de7a887686eb6dd960766cabc0c4a6336c8df1 100644 (file)
--- a/git.html
+++ b/git.html
@@ -623,6 +623,14 @@ ancillary user utilities.</p>
 </p>\r
 </dd>\r
 <dt>\r
+<a href="git-submodule.html">git-submodule(1)</a>\r
+</dt>\r
+<dd>\r
+<p>\r
+        Initialize, update or inspect submodules.\r
+</p>\r
+</dd>\r
+<dt>\r
 <a href="git-tag.html">git-tag(1)</a>\r
 </dt>\r
 <dd>\r
@@ -734,14 +742,6 @@ ancillary user utilities.</p>
 </p>\r
 </dd>\r
 <dt>\r
-<a href="git-applymbox.html">git-applymbox(1)</a>\r
-</dt>\r
-<dd>\r
-<p>\r
-        Apply a series of patches in a mailbox.\r
-</p>\r
-</dd>\r
-<dt>\r
 <a href="git-blame.html">git-blame(1)</a>\r
 </dt>\r
 <dd>\r
@@ -1362,14 +1362,6 @@ typically do not use them directly.</p>
 users typically do not use them directly.</p>\r
 <dl>\r
 <dt>\r
-<a href="git-applypatch.html">git-applypatch(1)</a>\r
-</dt>\r
-<dd>\r
-<p>\r
-        Apply one patch extracted from an e-mail.\r
-</p>\r
-</dd>\r
-<dt>\r
 <a href="git-check-attr.html">git-check-attr(1)</a>\r
 </dt>\r
 <dd>\r
@@ -2333,7 +2325,7 @@ contributors on the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 02-Jun-2007 21:10:18 UTC\r
+Last updated 03-Jun-2007 08:39:38 UTC\r
 </div>\r
 </div>\r
 </body>\r
index 2f910a9e3b2fdbf6ef3528d38c4c81f98dc1653d..cb170c17b5d6607bd512872a3d484bcfb85de300 100644 (file)
@@ -273,11 +273,10 @@ all disabled.  To enable a hook, make it executable with <tt>chmod +x</tt>.</p>
 </div>\r
 <h2>applypatch-msg</h2>\r
 <div class="sectionbody">\r
-<p>This hook is invoked by <tt>git-applypatch</tt> script, which is\r
-typically invoked by <tt>git-applymbox</tt>.  It takes a single\r
+<p>This hook is invoked by <tt>git-am</tt> script.  It takes a single\r
 parameter, the name of the file that holds the proposed commit\r
 log message.  Exiting with non-zero status causes\r
-<tt>git-applypatch</tt> to abort before applying the patch.</p>\r
+<tt>git-am</tt> to abort before applying the patch.</p>\r
 <p>The hook is allowed to edit the message file in place, and can\r
 be used to normalize the message into some project standard\r
 format (if the project has one). It can also be used to refuse\r
@@ -287,8 +286,7 @@ the commit after inspecting the message file.</p>
 </div>\r
 <h2>pre-applypatch</h2>\r
 <div class="sectionbody">\r
-<p>This hook is invoked by <tt>git-applypatch</tt> script, which is\r
-typically invoked by <tt>git-applymbox</tt>.  It takes no parameter,\r
+<p>This hook is invoked by <tt>git-am</tt>.  It takes no parameter,\r
 and is invoked after the patch is applied, but before a commit\r
 is made.  Exiting with non-zero status causes the working tree\r
 after application of the patch not committed.</p>\r
@@ -299,11 +297,10 @@ make a commit if it does not pass certain test.</p>
 </div>\r
 <h2>post-applypatch</h2>\r
 <div class="sectionbody">\r
-<p>This hook is invoked by <tt>git-applypatch</tt> script, which is\r
-typically invoked by <tt>git-applymbox</tt>.  It takes no parameter,\r
+<p>This hook is invoked by <tt>git-am</tt>.  It takes no parameter,\r
 and is invoked after the patch is applied and a commit is made.</p>\r
 <p>This hook is meant primarily for notification, and cannot affect\r
-the outcome of <tt>git-applypatch</tt>.</p>\r
+the outcome of <tt>git-am</tt>.</p>\r
 </div>\r
 <h2>pre-commit</h2>\r
 <div class="sectionbody">\r
@@ -459,7 +456,7 @@ for the user.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 02-Jun-2007 21:10:22 UTC\r
+Last updated 03-Jun-2007 08:39:38 UTC\r
 </div>\r
 </div>\r
 </body>\r
index aabb9750fddbc28091c46780ccf7b835b62b04c7..6836477ca816a6caa860960c3456cfbbf5cd32f1 100644 (file)
--- a/hooks.txt
+++ b/hooks.txt
@@ -12,11 +12,10 @@ This document describes the currently defined hooks.
 applypatch-msg
 --------------
 
-This hook is invoked by `git-applypatch` script, which is
-typically invoked by `git-applymbox`.  It takes a single
+This hook is invoked by `git-am` script.  It takes a single
 parameter, the name of the file that holds the proposed commit
 log message.  Exiting with non-zero status causes
-`git-applypatch` to abort before applying the patch.
+`git-am` to abort before applying the patch.
 
 The hook is allowed to edit the message file in place, and can
 be used to normalize the message into some project standard
@@ -29,8 +28,7 @@ The default 'applypatch-msg' hook, when enabled, runs the
 pre-applypatch
 --------------
 
-This hook is invoked by `git-applypatch` script, which is
-typically invoked by `git-applymbox`.  It takes no parameter,
+This hook is invoked by `git-am`.  It takes no parameter,
 and is invoked after the patch is applied, but before a commit
 is made.  Exiting with non-zero status causes the working tree
 after application of the patch not committed.
@@ -44,12 +42,11 @@ The default 'pre-applypatch' hook, when enabled, runs the
 post-applypatch
 ---------------
 
-This hook is invoked by `git-applypatch` script, which is
-typically invoked by `git-applymbox`.  It takes no parameter,
+This hook is invoked by `git-am`.  It takes no parameter,
 and is invoked after the patch is applied and a commit is made.
 
 This hook is meant primarily for notification, and cannot affect
-the outcome of `git-applypatch`.
+the outcome of `git-am`.
 
 pre-commit
 ----------