2006-04-06 03:32:19 +00:00
|
|
|
git-imap-send(1)
|
|
|
|
================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2008-07-09 21:29:02 +00:00
|
|
|
git-imap-send - Send a collection of patches from stdin to an IMAP folder
|
2006-04-06 03:32:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2014-11-09 14:55:53 +00:00
|
|
|
'git imap-send' [-v] [-q] [--[no-]curl]
|
2006-04-06 03:32:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-01-09 23:33:00 +00:00
|
|
|
This command uploads a mailbox generated with 'git format-patch'
|
2008-07-09 21:29:02 +00:00
|
|
|
into an IMAP drafts folder. This allows patches to be sent as
|
|
|
|
other email is when using mail clients that cannot read mailbox
|
2010-03-22 18:07:52 +00:00
|
|
|
files directly. The command also works with any general mailbox
|
|
|
|
in which emails have the fields "From", "Date", and "Subject" in
|
|
|
|
that order.
|
2006-04-06 03:32:19 +00:00
|
|
|
|
|
|
|
Typical usage is something like:
|
|
|
|
|
2008-06-30 06:09:04 +00:00
|
|
|
git format-patch --signoff --stdout --attach origin | git imap-send
|
2006-04-06 03:32:19 +00:00
|
|
|
|
|
|
|
|
2014-11-05 14:29:21 +00:00
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
|
|
|
|
-v::
|
|
|
|
--verbose::
|
|
|
|
Be verbose.
|
|
|
|
|
|
|
|
-q::
|
|
|
|
--quiet::
|
|
|
|
Be quiet.
|
|
|
|
|
2014-11-09 14:55:53 +00:00
|
|
|
--curl::
|
|
|
|
Use libcurl to communicate with the IMAP server, unless tunneling
|
|
|
|
into it. Ignored if Git was built without the USE_CURL_FOR_IMAP_SEND
|
|
|
|
option set.
|
|
|
|
|
|
|
|
--no-curl::
|
|
|
|
Talk to the IMAP server using git's own IMAP routines instead of
|
2015-03-08 05:13:55 +00:00
|
|
|
using libcurl. Ignored if Git was built with the NO_OPENSSL option
|
|
|
|
set.
|
2014-11-09 14:55:53 +00:00
|
|
|
|
2014-11-05 14:29:21 +00:00
|
|
|
|
2006-04-06 03:32:19 +00:00
|
|
|
CONFIGURATION
|
|
|
|
-------------
|
|
|
|
|
2020-08-30 22:01:18 +00:00
|
|
|
To use the tool, `imap.folder` and either `imap.tunnel` or `imap.host` must be set
|
2008-07-09 21:29:02 +00:00
|
|
|
to appropriate values.
|
|
|
|
|
2018-10-27 06:23:10 +00:00
|
|
|
include::config/imap.txt[]
|
2010-02-16 06:34:07 +00:00
|
|
|
|
2020-08-30 22:01:18 +00:00
|
|
|
EXAMPLES
|
|
|
|
--------
|
2008-07-09 21:29:02 +00:00
|
|
|
Using tunnel mode:
|
2006-04-06 03:32:19 +00:00
|
|
|
|
2006-05-05 19:05:10 +00:00
|
|
|
..........................
|
2006-04-06 03:32:19 +00:00
|
|
|
[imap]
|
2008-07-09 21:29:02 +00:00
|
|
|
folder = "INBOX.Drafts"
|
|
|
|
tunnel = "ssh -q -C user@example.com /usr/bin/imapd ./Maildir 2> /dev/null"
|
|
|
|
..........................
|
2006-04-06 03:32:19 +00:00
|
|
|
|
2008-07-09 21:29:02 +00:00
|
|
|
Using direct mode:
|
|
|
|
|
|
|
|
.........................
|
2006-04-06 03:32:19 +00:00
|
|
|
[imap]
|
2008-07-09 21:29:02 +00:00
|
|
|
folder = "INBOX.Drafts"
|
|
|
|
host = imap://imap.example.com
|
|
|
|
user = bob
|
|
|
|
pass = p4ssw0rd
|
2014-10-11 23:37:34 +00:00
|
|
|
.........................
|
2008-07-09 21:29:02 +00:00
|
|
|
|
|
|
|
Using direct mode with SSL:
|
2006-04-06 03:32:19 +00:00
|
|
|
|
2008-07-09 21:29:02 +00:00
|
|
|
.........................
|
2006-04-06 03:32:19 +00:00
|
|
|
[imap]
|
2008-07-09 21:29:02 +00:00
|
|
|
folder = "INBOX.Drafts"
|
|
|
|
host = imaps://imap.example.com
|
|
|
|
user = bob
|
|
|
|
pass = p4ssw0rd
|
|
|
|
port = 123
|
2008-07-09 21:29:00 +00:00
|
|
|
sslverify = false
|
2014-10-11 23:37:34 +00:00
|
|
|
.........................
|
2006-04-06 03:32:19 +00:00
|
|
|
|
|
|
|
|
2020-08-30 22:01:18 +00:00
|
|
|
Using Gmail's IMAP interface:
|
2011-04-15 02:33:57 +00:00
|
|
|
|
|
|
|
---------
|
|
|
|
[imap]
|
|
|
|
folder = "[Gmail]/Drafts"
|
|
|
|
host = imaps://imap.gmail.com
|
|
|
|
user = user@gmail.com
|
|
|
|
port = 993
|
|
|
|
sslverify = false
|
|
|
|
---------
|
|
|
|
|
2020-08-30 22:01:18 +00:00
|
|
|
You might need to instead use: `folder = "[Google Mail]/Drafts"` if you get an error
|
2011-04-15 02:33:57 +00:00
|
|
|
that the "Folder doesn't exist".
|
|
|
|
|
|
|
|
Once the commits are ready to be sent, run the following command:
|
|
|
|
|
|
|
|
$ git format-patch --cover-letter -M --stdout origin/master | git imap-send
|
|
|
|
|
2020-08-30 22:01:18 +00:00
|
|
|
Just make sure to disable line wrapping in the email client (Gmail's web
|
2011-04-15 02:33:57 +00:00
|
|
|
interface will wrap lines no matter what, so you need to use a real
|
|
|
|
IMAP client).
|
|
|
|
|
2009-02-12 21:17:04 +00:00
|
|
|
CAUTION
|
|
|
|
-------
|
|
|
|
It is still your responsibility to make sure that the email message
|
|
|
|
sent by your email program meets the standards of your project.
|
|
|
|
Many projects do not like patches to be attached. Some mail
|
|
|
|
agents will transform patches (e.g. wrap lines, send them as
|
|
|
|
format=flowed) in ways that make them fail. You will get angry
|
|
|
|
flames ridiculing you if you don't check this.
|
|
|
|
|
|
|
|
Thunderbird in particular is known to be problematic. Thunderbird
|
|
|
|
users may wish to visit this web page for more information:
|
|
|
|
http://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email
|
|
|
|
|
2011-04-15 02:33:57 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
linkgit:git-format-patch[1], linkgit:git-send-email[1], mbox(5)
|
|
|
|
|
2006-04-06 03:32:19 +00:00
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|