A CVS server emulator for git.
linkgit:git-imap-send[1]::
- Dump a mailbox from stdin into an imap folder.
+ Send a collection of patches from stdin to an IMAP folder.
linkgit:git-quiltimport[1]::
Applies a quilt patchset onto the current branch.
affects only 'git-diff' Porcelain, and not lower level
'diff' commands, such as 'git-diff-files'.
+diff.suppress-blank-empty::
+ A boolean to inhibit the standard behavior of printing a space
+ before each empty output line. Defaults to false.
+
diff.external::
If this config variable is set, diff generation is not
performed using the internal diff machinery, but using the
--exit-code.
--full-index::
- Instead of the first handful characters, show full
- object name of pre- and post-image blob on the "index"
- line when generating a patch format output.
+ Instead of the first handful of characters, show the full
+ pre- and post-image blob object names on the "index"
+ line when generating patch format output.
--binary::
In addition to --full-index, output "binary diff" that
<h2>SYNOPSIS</h2>\r
<div class="sectionbody">\r
<div class="verseblock">\r
-<div class="content"><em>git checkout</em> [-q] [-f] [[--track | --no-track] -b <new_branch> [-l]] [-m] [<branch>]\r
+<div class="content"><em>git checkout</em> [-q] [-f] [--track | --no-track] [-b <new_branch> [-l]] [-m] [<branch>]\r
<em>git checkout</em> [<tree-ish>] [--] <paths>…</div></div>\r
</div>\r
<h2 id="_description">DESCRIPTION</h2>\r
specified, <new_branch>. Using -b will cause <new_branch> to\r
be created; in this case you can use the --track or --no-track\r
options, which will be passed to <tt>git branch</tt>.</p></div>\r
+<div class="para"><p>As a convenience, --track will default to create a branch whose\r
+name is constructed from the specified branch name by stripping\r
+the first namespace level.</p></div>\r
<div class="para"><p>When <paths> are given, this command does <strong>not</strong> switch\r
branches. It updates the named paths in the working tree from\r
the index file (i.e. it runs <tt>git checkout-index -f -u</tt>), or\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
+<div class="para"><p>If no <em>-b</em> option was given, a name will be made up for you, by stripping\r
+the part up to the first slash of the tracked branch. For example, if you\r
+called <em>git checkout --track origin/next</em>, the branch name will be <em>next</em>.</p></div>\r
</dd>\r
<dt>\r
--no-track\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-26 06:45:37 UTC\r
+Last updated 2008-08-20 09:13:27 UTC\r
</div>\r
</div>\r
</body>\r
SYNOPSIS
--------
[verse]
-'git checkout' [-q] [-f] [[--track | --no-track] -b <new_branch> [-l]] [-m] [<branch>]
+'git checkout' [-q] [-f] [--track | --no-track] [-b <new_branch> [-l]] [-m] [<branch>]
'git checkout' [<tree-ish>] [--] <paths>...
DESCRIPTION
be created; in this case you can use the --track or --no-track
options, which will be passed to `git branch`.
+As a convenience, --track will default to create a branch whose
+name is constructed from the specified branch name by stripping
+the first namespace level.
+
When <paths> are given, this command does *not* switch
branches. It updates the named paths in the working tree from
the index file (i.e. it runs `git checkout-index -f -u`), or
'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.
++
+If no '-b' option was given, a name will be made up for you, by stripping
+the part up to the first slash of the tracked branch. For example, if you
+called 'git checkout --track origin/next', the branch name will be 'next'.
--no-track::
Ignore the branch.autosetupmerge configuration variable.
</p>\r
</dd>\r
<dt>\r
+diff.suppress-blank-empty\r
+</dt>\r
+<dd>\r
+<p>\r
+ A boolean to inhibit the standard behavior of printing a space\r
+ before each empty output line. Defaults to false.\r
+</p>\r
+</dd>\r
+<dt>\r
diff.external\r
</dt>\r
<dd>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-08-16 10:22:58 UTC\r
+Last updated 2008-08-20 09:13:27 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-22 09:19:06 UTC\r
+Last updated 2008-08-20 09:13:28 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-22 09:19:06 UTC\r
+Last updated 2008-08-20 09:13:29 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-08-07 00:17:34 UTC\r
+Last updated 2008-08-20 09:13:30 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-22 09:19:07 UTC\r
+Last updated 2008-08-20 09:13:30 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-08-15 05:34:27 UTC\r
+Last updated 2008-08-20 09:13:32 UTC\r
</div>\r
</div>\r
</body>\r
</div>\r
<h2>SYNOPSIS</h2>\r
<div class="sectionbody">\r
-<div class="para"><p><em>git hash-object</em> [-t <type>] [-w] [--stdin | --stdin-paths] [--] <file>…</p></div>\r
+<div class="verseblock">\r
+<div class="content"><em>git hash-object</em> [-t <type>] [-w] [--path=<file>|--no-filters] [--stdin] [--] <file>…\r
+<em>git hash-object</em> [-t <type>] [-w] --stdin-paths < <list-of-paths></div></div>\r
</div>\r
<h2 id="_description">DESCRIPTION</h2>\r
<div class="sectionbody">\r
Read file names from stdin instead of from the command-line.\r
</p>\r
</dd>\r
+<dt>\r
+--path\r
+</dt>\r
+<dd>\r
+<p>\r
+ Hash object as it were located at the given path. The location of\r
+ file does not directly influence on the hash value, but path is\r
+ used to determine what git filters should be applied to the object\r
+ before it can be placed to the object database, and, as result of\r
+ applying filters, the actual blob put into the object database may\r
+ differ from the given file. This option is mainly useful for hashing\r
+ temporary files located outside of the working directory or files\r
+ read from stdin.\r
+</p>\r
+</dd>\r
+<dt>\r
+--no-filters\r
+</dt>\r
+<dd>\r
+<p>\r
+ Hash the contents as is, ignoring any input filter that would\r
+ have been chosen by the attributes mechanism, including crlf\r
+ conversion. If the file is read from standard input then this\r
+ is always implied, unless the --path option is given.\r
+</p>\r
+</dd>\r
</dl></div>\r
</div>\r
<h2 id="_author">Author</h2>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-22 09:19:10 UTC\r
+Last updated 2008-08-20 09:13:32 UTC\r
</div>\r
</div>\r
</body>\r
SYNOPSIS
--------
-'git hash-object' [-t <type>] [-w] [--stdin | --stdin-paths] [--] <file>...
+[verse]
+'git hash-object' [-t <type>] [-w] [--path=<file>|--no-filters] [--stdin] [--] <file>...
+'git hash-object' [-t <type>] [-w] --stdin-paths < <list-of-paths>
DESCRIPTION
-----------
--stdin-paths::
Read file names from stdin instead of from the command-line.
+--path::
+ Hash object as it were located at the given path. The location of
+ file does not directly influence on the hash value, but path is
+ used to determine what git filters should be applied to the object
+ before it can be placed to the object database, and, as result of
+ applying filters, the actual blob put into the object database may
+ differ from the given file. This option is mainly useful for hashing
+ temporary files located outside of the working directory or files
+ read from stdin.
+
+--no-filters::
+ Hash the contents as is, ignoring any input filter that would
+ have been chosen by the attributes mechanism, including crlf
+ conversion. If the file is read from standard input then this
+ is always implied, unless the --path option is given.
+
Author
------
Written by Junio C Hamano <gitster@pobox.com>
<h2>NAME</h2>\r
<div class="sectionbody">\r
<p>git-imap-send -\r
- Dump a mailbox from stdin into an imap folder\r
+ Send a collection of patches from stdin to an IMAP folder\r
</p>\r
</div>\r
</div>\r
</div>\r
<h2 id="_description">DESCRIPTION</h2>\r
<div class="sectionbody">\r
-<div class="para"><p>This command uploads a mailbox generated with git-format-patch\r
-into an imap drafts folder. This allows patches to be sent as\r
-other email is sent with mail clients that cannot read mailbox\r
+<div class="para"><p>This command uploads a mailbox generated with <em>git-format-patch</em>\r
+into an IMAP drafts folder. This allows patches to be sent as\r
+other email is when using mail clients that cannot read mailbox\r
files directly.</p></div>\r
<div class="para"><p>Typical usage is something like:</p></div>\r
<div class="para"><p>git format-patch --signoff --stdout --attach origin | git imap-send</p></div>\r
</div>\r
<h2 id="_configuration">CONFIGURATION</h2>\r
<div class="sectionbody">\r
-<div class="para"><p><em>git-imap-send</em> requires the following values in the repository\r
-configuration file (shown with examples):</p></div>\r
+<div class="para"><p>To use the tool, imap.folder and either imap.tunnel or imap.host must be set\r
+to appropriate values.</p></div>\r
+<h3 id="_variables">Variables</h3><div style="clear:left"></div>\r
+<div class="vlist"><dl>\r
+<dt>\r
+imap.folder\r
+</dt>\r
+<dd>\r
+<p>\r
+ The folder to drop the mails into, which is typically the Drafts\r
+ folder. For example: "INBOX.Drafts", "INBOX/Drafts" or\r
+ "[Gmail]/Drafts". Required to use imap-send.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.tunnel\r
+</dt>\r
+<dd>\r
+<p>\r
+ Command used to setup a tunnel to the IMAP server through which\r
+ commands will be piped instead of using a direct network connection\r
+ to the server. Required when imap.host is not set to use imap-send.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.host\r
+</dt>\r
+<dd>\r
+<p>\r
+ A URL identifying the server. Use a <tt>imap://</tt> prefix for non-secure\r
+ connections and a <tt>imaps://</tt> prefix for secure connections.\r
+ Ignored when imap.tunnel is set, but required to use imap-send\r
+ otherwise.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.user\r
+</dt>\r
+<dd>\r
+<p>\r
+ The username to use when logging in to the server.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.password\r
+</dt>\r
+<dd>\r
+<p>\r
+ The password to use when logging in to the server.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.port\r
+</dt>\r
+<dd>\r
+<p>\r
+ An integer port number to connect to on the server.\r
+ Defaults to 143 for imap:// hosts and 993 for imaps:// hosts.\r
+ Ignored when imap.tunnel is set.\r
+</p>\r
+</dd>\r
+<dt>\r
+imap.sslverify\r
+</dt>\r
+<dd>\r
+<p>\r
+ A boolean to enable/disable verification of the server certificate\r
+ used by the SSL/TLS connection. Default is <tt>true</tt>. Ignored when\r
+ imap.tunnel is set.\r
+</p>\r
+</dd>\r
+</dl></div>\r
+<h3 id="_examples">Examples</h3><div style="clear:left"></div>\r
+<div class="para"><p>Using tunnel mode:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
<pre><tt>[imap]\r
- Folder = "INBOX.Drafts"\r
-\r
-[imap]\r
- Tunnel = "ssh -q user@server.com /usr/bin/imapd ./Maildir 2> /dev/null"\r
-\r
-[imap]\r
- Host = imap.server.com\r
- User = bob\r
- Pass = pwd\r
- Port = 143</tt></pre>\r
+ folder = "INBOX.Drafts"\r
+ tunnel = "ssh -q -C user@example.com /usr/bin/imapd ./Maildir 2> /dev/null"</tt></pre>\r
+</div></div>\r
+<div class="para"><p>Using direct mode:</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>[imap]\r
+ folder = "INBOX.Drafts"\r
+ host = imap://imap.example.com\r
+ user = bob\r
+ pass = p4ssw0rd</tt></pre>\r
+</div></div>\r
+<div class="para"><p>Using direct mode with SSL:</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><tt>[imap]\r
+ folder = "INBOX.Drafts"\r
+ host = imaps://imap.example.com\r
+ user = bob\r
+ pass = p4ssw0rd\r
+ port = 123\r
+ sslverify = false</tt></pre>\r
</div></div>\r
</div>\r
<h2 id="_bugs">BUGS</h2>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-07-06 05:16:50 UTC\r
+Last updated 2008-08-20 09:13:32 UTC\r
</div>\r
</div>\r
</body>\r
NAME
----
-git-imap-send - Dump a mailbox from stdin into an imap folder
+git-imap-send - Send a collection of patches from stdin to an IMAP folder
SYNOPSIS
DESCRIPTION
-----------
-This command uploads a mailbox generated with git-format-patch
-into an imap drafts folder. This allows patches to be sent as
-other email is sent with mail clients that cannot read mailbox
+This command uploads a mailbox generated with 'git-format-patch'
+into an IMAP drafts folder. This allows patches to be sent as
+other email is when using mail clients that cannot read mailbox
files directly.
Typical usage is something like:
CONFIGURATION
-------------
-'git-imap-send' requires the following values in the repository
-configuration file (shown with examples):
+To use the tool, imap.folder and either imap.tunnel or imap.host must be set
+to appropriate values.
+
+Variables
+~~~~~~~~~
+
+imap.folder::
+ The folder to drop the mails into, which is typically the Drafts
+ folder. For example: "INBOX.Drafts", "INBOX/Drafts" or
+ "[Gmail]/Drafts". Required to use imap-send.
+
+imap.tunnel::
+ Command used to setup a tunnel to the IMAP server through which
+ commands will be piped instead of using a direct network connection
+ to the server. Required when imap.host is not set to use imap-send.
+
+imap.host::
+ A URL identifying the server. Use a `imap://` prefix for non-secure
+ connections and a `imaps://` prefix for secure connections.
+ Ignored when imap.tunnel is set, but required to use imap-send
+ otherwise.
+
+imap.user::
+ The username to use when logging in to the server.
+
+imap.password::
+ The password to use when logging in to the server.
+
+imap.port::
+ An integer port number to connect to on the server.
+ Defaults to 143 for imap:// hosts and 993 for imaps:// hosts.
+ Ignored when imap.tunnel is set.
+
+imap.sslverify::
+ A boolean to enable/disable verification of the server certificate
+ used by the SSL/TLS connection. Default is `true`. Ignored when
+ imap.tunnel is set.
+
+Examples
+~~~~~~~~
+
+Using tunnel mode:
..........................
[imap]
- Folder = "INBOX.Drafts"
+ folder = "INBOX.Drafts"
+ tunnel = "ssh -q -C user@example.com /usr/bin/imapd ./Maildir 2> /dev/null"
+..........................
+Using direct mode:
+
+.........................
[imap]
- Tunnel = "ssh -q user@server.com /usr/bin/imapd ./Maildir 2> /dev/null"
+ folder = "INBOX.Drafts"
+ host = imap://imap.example.com
+ user = bob
+ pass = p4ssw0rd
+..........................
+
+Using direct mode with SSL:
+.........................
[imap]
- Host = imap.server.com
- User = bob
- Pass = pwd
- Port = 143
+ folder = "INBOX.Drafts"
+ host = imaps://imap.example.com
+ user = bob
+ pass = p4ssw0rd
+ port = 123
+ sslverify = false
..........................
</dt>\r
<dd>\r
<p>\r
- Instead of the first handful characters, show full\r
- object name of pre- and post-image blob on the "index"\r
- line when generating a patch format output.\r
+ Instead of the first handful of characters, show the full\r
+ pre- and post-image blob object names on the "index"\r
+ line when generating patch format output.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-08-13 20:03:49 UTC\r
+Last updated 2008-08-20 09:13:33 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Dump a mailbox from stdin into an imap folder.\r
+ Send a collection of patches from stdin to an IMAP folder.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2008-08-17 21:04:42 UTC\r
+Last updated 2008-08-20 09:13:33 UTC\r
</div>\r
</div>\r
</body>\r