]>
Commit | Line | Data |
---|---|---|
454a35b8 MM |
1 | git-imap-send(1) |
2 | ================ | |
3 | ||
4 | NAME | |
5 | ---- | |
c82b0748 | 6 | git-imap-send - Send a collection of patches from stdin to an IMAP folder |
454a35b8 MM |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
7791a1d9 | 11 | [verse] |
1e16b255 | 12 | 'git imap-send' [-v] [-q] [--[no-]curl] |
454a35b8 MM |
13 | |
14 | ||
15 | DESCRIPTION | |
16 | ----------- | |
0b444cdb | 17 | This command uploads a mailbox generated with 'git format-patch' |
c82b0748 RS |
18 | into an IMAP drafts folder. This allows patches to be sent as |
19 | other email is when using mail clients that cannot read mailbox | |
4916c8f9 RR |
20 | files directly. The command also works with any general mailbox |
21 | in which emails have the fields "From", "Date", and "Subject" in | |
22 | that order. | |
454a35b8 MM |
23 | |
24 | Typical usage is something like: | |
25 | ||
b1889c36 | 26 | git format-patch --signoff --stdout --attach origin | git imap-send |
454a35b8 MM |
27 | |
28 | ||
f1a35295 BR |
29 | OPTIONS |
30 | ------- | |
31 | ||
32 | -v:: | |
33 | --verbose:: | |
34 | Be verbose. | |
35 | ||
36 | -q:: | |
37 | --quiet:: | |
38 | Be quiet. | |
39 | ||
1e16b255 BR |
40 | --curl:: |
41 | Use libcurl to communicate with the IMAP server, unless tunneling | |
42 | into it. Ignored if Git was built without the USE_CURL_FOR_IMAP_SEND | |
43 | option set. | |
44 | ||
45 | --no-curl:: | |
46 | Talk to the IMAP server using git's own IMAP routines instead of | |
dcd01ea1 KM |
47 | using libcurl. Ignored if Git was built with the NO_OPENSSL option |
48 | set. | |
1e16b255 | 49 | |
f1a35295 | 50 | |
454a35b8 MM |
51 | CONFIGURATION |
52 | ------------- | |
53 | ||
587e69b5 | 54 | To use the tool, `imap.folder` and either `imap.tunnel` or `imap.host` must be set |
c82b0748 RS |
55 | to appropriate values. |
56 | ||
18d89fe2 ÆAB |
57 | include::includes/cmd-config-section-rest.txt[] |
58 | ||
ae461026 | 59 | include::config/imap.txt[] |
ae9c606e | 60 | |
587e69b5 PB |
61 | EXAMPLES |
62 | -------- | |
c82b0748 | 63 | Using tunnel mode: |
454a35b8 | 64 | |
2b5f3ed3 | 65 | .......................... |
454a35b8 | 66 | [imap] |
c82b0748 RS |
67 | folder = "INBOX.Drafts" |
68 | tunnel = "ssh -q -C user@example.com /usr/bin/imapd ./Maildir 2> /dev/null" | |
69 | .......................... | |
454a35b8 | 70 | |
c82b0748 RS |
71 | Using direct mode: |
72 | ||
73 | ......................... | |
454a35b8 | 74 | [imap] |
c82b0748 RS |
75 | folder = "INBOX.Drafts" |
76 | host = imap://imap.example.com | |
77 | user = bob | |
78 | pass = p4ssw0rd | |
f8a48aff | 79 | ......................... |
c82b0748 RS |
80 | |
81 | Using direct mode with SSL: | |
454a35b8 | 82 | |
c82b0748 | 83 | ......................... |
454a35b8 | 84 | [imap] |
c82b0748 RS |
85 | folder = "INBOX.Drafts" |
86 | host = imaps://imap.example.com | |
87 | user = bob | |
88 | pass = p4ssw0rd | |
89 | port = 123 | |
08a694bb | 90 | ; sslVerify = false |
f8a48aff | 91 | ......................... |
454a35b8 MM |
92 | |
93 | ||
08a694bb PB |
94 | [NOTE] |
95 | You may want to use `sslVerify=false` | |
96 | while troubleshooting, if you suspect that the reason you are | |
97 | having trouble connecting is because the certificate you use at | |
98 | the private server `example.com` you are trying to set up (or | |
99 | have set up) may not be verified correctly. | |
100 | ||
587e69b5 | 101 | Using Gmail's IMAP interface: |
36c10e6d JN |
102 | |
103 | --------- | |
104 | [imap] | |
105 | folder = "[Gmail]/Drafts" | |
106 | host = imaps://imap.gmail.com | |
107 | user = user@gmail.com | |
108 | port = 993 | |
36c10e6d JN |
109 | --------- |
110 | ||
08a694bb | 111 | [NOTE] |
587e69b5 | 112 | You might need to instead use: `folder = "[Google Mail]/Drafts"` if you get an error |
36c10e6d JN |
113 | that the "Folder doesn't exist". |
114 | ||
1bbac2a8 PB |
115 | [NOTE] |
116 | If your Gmail account is set to another language than English, the name of the "Drafts" | |
117 | folder will be localized. | |
118 | ||
36c10e6d JN |
119 | Once the commits are ready to be sent, run the following command: |
120 | ||
121 | $ git format-patch --cover-letter -M --stdout origin/master | git imap-send | |
122 | ||
587e69b5 | 123 | Just make sure to disable line wrapping in the email client (Gmail's web |
36c10e6d JN |
124 | interface will wrap lines no matter what, so you need to use a real |
125 | IMAP client). | |
126 | ||
1a526d48 JW |
127 | CAUTION |
128 | ------- | |
129 | It is still your responsibility to make sure that the email message | |
130 | sent by your email program meets the standards of your project. | |
131 | Many projects do not like patches to be attached. Some mail | |
132 | agents will transform patches (e.g. wrap lines, send them as | |
133 | format=flowed) in ways that make them fail. You will get angry | |
134 | flames ridiculing you if you don't check this. | |
135 | ||
136 | Thunderbird in particular is known to be problematic. Thunderbird | |
137 | users may wish to visit this web page for more information: | |
d05b08cd | 138 | https://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email |
1a526d48 | 139 | |
36c10e6d JN |
140 | SEE ALSO |
141 | -------- | |
142 | linkgit:git-format-patch[1], linkgit:git-send-email[1], mbox(5) | |
143 | ||
454a35b8 MM |
144 | GIT |
145 | --- | |
9e1f0a85 | 146 | Part of the linkgit:git[1] suite |