Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 1 | .. _email_clients: |
| 2 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 3 | Email clients info for Linux |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 4 | ============================ |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 5 | |
Dan Carpenter | 7d19e91 | 2014-06-27 18:28:46 -0700 | [diff] [blame] | 6 | Git |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 7 | --- |
Dan Carpenter | 7d19e91 | 2014-06-27 18:28:46 -0700 | [diff] [blame] | 8 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 9 | These days most developers use ``git send-email`` instead of regular |
| 10 | email clients. The man page for this is quite good. On the receiving |
| 11 | end, maintainers use ``git am`` to apply the patches. |
| 12 | |
| 13 | If you are new to ``git`` then send your first patch to yourself. Save it |
| 14 | as raw text including all the headers. Run ``git am raw_email.txt`` and |
| 15 | then review the changelog with ``git log``. When that works then send |
Dan Carpenter | 7d19e91 | 2014-06-27 18:28:46 -0700 | [diff] [blame] | 16 | the patch to the appropriate mailing list(s). |
| 17 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 18 | General Preferences |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 19 | ------------------- |
| 20 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 21 | Patches for the Linux kernel are submitted via email, preferably as |
| 22 | inline text in the body of the email. Some maintainers accept |
| 23 | attachments, but then the attachments should have content-type |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 24 | ``text/plain``. However, attachments are generally frowned upon because |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 25 | it makes quoting portions of the patch more difficult in the patch |
| 26 | review process. |
| 27 | |
Drew DeVault | 7433ff3 | 2020-09-03 12:05:43 -0400 | [diff] [blame] | 28 | It's also strongly recommended that you use plain text in your email body, |
| 29 | for patches and other emails alike. https://useplaintext.email may be useful |
| 30 | for information on how to configure your preferred email client, as well as |
| 31 | listing recommended email clients should you not already have a preference. |
| 32 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 33 | Email clients that are used for Linux kernel patches should send the |
| 34 | patch text untouched. For example, they should not modify or delete tabs |
| 35 | or spaces, even at the beginning or end of lines. |
| 36 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 37 | Don't send patches with ``format=flowed``. This can cause unexpected |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 38 | and unwanted line breaks. |
| 39 | |
| 40 | Don't let your email client do automatic word wrapping for you. |
| 41 | This can also corrupt your patch. |
| 42 | |
| 43 | Email clients should not modify the character set encoding of the text. |
| 44 | Emailed patches should be in ASCII or UTF-8 encoding only. |
| 45 | If you configure your email client to send emails with UTF-8 encoding, |
| 46 | you avoid some possible charset problems. |
| 47 | |
Federico Vaga | e226b4f | 2019-07-06 23:01:00 +0200 | [diff] [blame] | 48 | Email clients should generate and maintain "References:" or "In-Reply-To:" |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 49 | headers so that mail threading is not broken. |
| 50 | |
| 51 | Copy-and-paste (or cut-and-paste) usually does not work for patches |
| 52 | because tabs are converted to spaces. Using xclipboard, xclip, and/or |
| 53 | xcutsel may work, but it's best to test this for yourself or just avoid |
| 54 | copy-and-paste. |
| 55 | |
| 56 | Don't use PGP/GPG signatures in mail that contains patches. |
| 57 | This breaks many scripts that read and apply the patches. |
| 58 | (This should be fixable.) |
| 59 | |
| 60 | It's a good idea to send a patch to yourself, save the received message, |
| 61 | and successfully apply it with 'patch' before sending patches to Linux |
| 62 | mailing lists. |
| 63 | |
| 64 | |
| 65 | Some email client (MUA) hints |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 66 | ----------------------------- |
| 67 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 68 | Here are some specific MUA configuration hints for editing and sending |
| 69 | patches for the Linux kernel. These are not meant to be complete |
| 70 | software package configuration summaries. |
| 71 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 72 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 73 | Legend: |
| 74 | |
| 75 | - TUI = text-based user interface |
| 76 | - GUI = graphical user interface |
| 77 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 78 | Alpine (TUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 79 | ************ |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 80 | |
| 81 | Config options: |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 82 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 83 | In the :menuselection:`Sending Preferences` section: |
| 84 | |
| 85 | - :menuselection:`Do Not Send Flowed Text` must be ``enabled`` |
| 86 | - :menuselection:`Strip Whitespace Before Sending` must be ``disabled`` |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 87 | |
| 88 | When composing the message, the cursor should be placed where the patch |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 89 | should appear, and then pressing :kbd:`CTRL-R` let you specify the patch file |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 90 | to insert into the message. |
| 91 | |
Richard Leitner | 04a3302 | 2014-12-02 17:44:36 +0100 | [diff] [blame] | 92 | Claws Mail (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 93 | **************** |
Richard Leitner | 04a3302 | 2014-12-02 17:44:36 +0100 | [diff] [blame] | 94 | |
| 95 | Works. Some people use this successfully for patches. |
| 96 | |
Federico Vaga | e226b4f | 2019-07-06 23:01:00 +0200 | [diff] [blame] | 97 | To insert a patch use :menuselection:`Message-->Insert File` (:kbd:`CTRL-I`) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 98 | or an external editor. |
Richard Leitner | 04a3302 | 2014-12-02 17:44:36 +0100 | [diff] [blame] | 99 | |
| 100 | If the inserted patch has to be edited in the Claws composition window |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 101 | "Auto wrapping" in |
| 102 | :menuselection:`Configuration-->Preferences-->Compose-->Wrapping` should be |
Richard Leitner | 04a3302 | 2014-12-02 17:44:36 +0100 | [diff] [blame] | 103 | disabled. |
| 104 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 105 | Evolution (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 106 | *************** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 107 | |
| 108 | Some people use this successfully for patches. |
| 109 | |
| 110 | When composing mail select: Preformat |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 111 | from :menuselection:`Format-->Paragraph Style-->Preformatted` (:kbd:`CTRL-7`) |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 112 | or the toolbar |
| 113 | |
| 114 | Then use: |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 115 | :menuselection:`Insert-->Text File...` (:kbd:`ALT-N x`) |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 116 | to insert the patch. |
| 117 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 118 | You can also ``diff -Nru old.c new.c | xclip``, select |
| 119 | :menuselection:`Preformat`, then paste with the middle button. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 120 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 121 | Kmail (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 122 | *********** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 123 | |
| 124 | Some people use Kmail successfully for patches. |
| 125 | |
| 126 | The default setting of not composing in HTML is appropriate; do not |
| 127 | enable it. |
| 128 | |
| 129 | When composing an email, under options, uncheck "word wrap". The only |
| 130 | disadvantage is any text you type in the email will not be word-wrapped |
| 131 | so you will have to manually word wrap text before the patch. The easiest |
| 132 | way around this is to compose your email with word wrap enabled, then save |
| 133 | it as a draft. Once you pull it up again from your drafts it is now hard |
| 134 | word-wrapped and you can uncheck "word wrap" without losing the existing |
| 135 | wrapping. |
| 136 | |
| 137 | At the bottom of your email, put the commonly-used patch delimiter before |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 138 | inserting your patch: three hyphens (``---``). |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 139 | |
Federico Vaga | e226b4f | 2019-07-06 23:01:00 +0200 | [diff] [blame] | 140 | Then from the :menuselection:`Message` menu item, select |
| 141 | :menuselection:`insert file` and choose your patch. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 142 | As an added bonus you can customise the message creation toolbar menu |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 143 | and put the :menuselection:`insert file` icon there. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 144 | |
Xishi Qiu | d9a6ed1 | 2013-11-06 13:18:19 -0800 | [diff] [blame] | 145 | Make the composer window wide enough so that no lines wrap. As of |
Lasse Collin | 5d3687d | 2011-01-12 17:00:28 -0800 | [diff] [blame] | 146 | KMail 1.13.5 (KDE 4.5.4), KMail will apply word wrapping when sending |
| 147 | the email if the lines wrap in the composer window. Having word wrapping |
| 148 | disabled in the Options menu isn't enough. Thus, if your patch has very |
| 149 | long lines, you must make the composer window very wide before sending |
| 150 | the email. See: https://bugs.kde.org/show_bug.cgi?id=174034 |
| 151 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 152 | You can safely GPG sign attachments, but inlined text is preferred for |
| 153 | patches so do not GPG sign them. Signing patches that have been inserted |
| 154 | as inlined text will make them tricky to extract from their 7-bit encoding. |
| 155 | |
| 156 | If you absolutely must send patches as attachments instead of inlining |
Federico Vaga | e226b4f | 2019-07-06 23:01:00 +0200 | [diff] [blame] | 157 | them as text, right click on the attachment and select :menuselection:`properties`, |
| 158 | and highlight :menuselection:`Suggest automatic display` to make the attachment |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 159 | inlined to make it more viewable. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 160 | |
| 161 | When saving patches that are sent as inlined text, select the email that |
| 162 | contains the patch from the message list pane, right click and select |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 163 | :menuselection:`save as`. You can use the whole email unmodified as a patch |
Federico Vaga | e226b4f | 2019-07-06 23:01:00 +0200 | [diff] [blame] | 164 | if it was properly composed. Emails are saved as read-write for user only so |
| 165 | you will have to chmod them to make them group and world readable if you copy |
| 166 | them elsewhere. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 167 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 168 | Lotus Notes (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 169 | ***************** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 170 | |
| 171 | Run away from it. |
| 172 | |
Stewart Smith | e34e20e | 2017-06-19 15:31:22 +1000 | [diff] [blame] | 173 | IBM Verse (Web GUI) |
| 174 | ******************* |
| 175 | |
| 176 | See Lotus Notes. |
| 177 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 178 | Mutt (TUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 179 | ********** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 180 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 181 | Plenty of Linux developers use ``mutt``, so it must work pretty well. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 182 | |
| 183 | Mutt doesn't come with an editor, so whatever editor you use should be |
| 184 | used in a way that there are no automatic linebreaks. Most editors have |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 185 | an :menuselection:`insert file` option that inserts the contents of a file |
| 186 | unaltered. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 187 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 188 | To use ``vim`` with mutt:: |
| 189 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 190 | set editor="vi" |
| 191 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 192 | If using xclip, type the command:: |
| 193 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 194 | :set paste |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 195 | |
| 196 | before middle button or shift-insert or use:: |
| 197 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 198 | :r filename |
| 199 | |
| 200 | if you want to include the patch inline. |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 201 | (a)ttach works fine without ``set paste``. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 202 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 203 | You can also generate patches with ``git format-patch`` and then use Mutt |
| 204 | to send them:: |
| 205 | |
Eddie Kovsky | 803cfe2 | 2015-11-05 23:23:01 -0700 | [diff] [blame] | 206 | $ mutt -H 0001-some-bug-fix.patch |
| 207 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 208 | Config options: |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 209 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 210 | It should work with default settings. |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 211 | However, it's a good idea to set the ``send_charset`` to:: |
| 212 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 213 | set send_charset="us-ascii:utf-8" |
| 214 | |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 215 | Mutt is highly customizable. Here is a minimum configuration to start |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 216 | using Mutt to send patches through Gmail:: |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 217 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 218 | # .muttrc |
| 219 | # ================ IMAP ==================== |
| 220 | set imap_user = 'yourusername@gmail.com' |
| 221 | set imap_pass = 'yourpassword' |
| 222 | set spoolfile = imaps://imap.gmail.com/INBOX |
| 223 | set folder = imaps://imap.gmail.com/ |
| 224 | set record="imaps://imap.gmail.com/[Gmail]/Sent Mail" |
| 225 | set postponed="imaps://imap.gmail.com/[Gmail]/Drafts" |
| 226 | set mbox="imaps://imap.gmail.com/[Gmail]/All Mail" |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 227 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 228 | # ================ SMTP ==================== |
| 229 | set smtp_url = "smtp://username@smtp.gmail.com:587/" |
| 230 | set smtp_pass = $imap_pass |
| 231 | set ssl_force_tls = yes # Require encrypted connection |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 232 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 233 | # ================ Composition ==================== |
| 234 | set editor = `echo \$EDITOR` |
| 235 | set edit_headers = yes # See the headers when editing |
| 236 | set charset = UTF-8 # value of $LANG; also fallback for send_charset |
| 237 | # Sender, email address, and sign-off line must match |
| 238 | unset use_domain # because joe@localhost is just embarrassing |
| 239 | set realname = "YOUR NAME" |
| 240 | set from = "username@gmail.com" |
| 241 | set use_from = yes |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 242 | |
| 243 | The Mutt docs have lots more information: |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 244 | |
Bhaskar Chowdhury | dff2c2e | 2020-02-18 15:10:13 +0530 | [diff] [blame] | 245 | https://gitlab.com/muttmua/mutt/-/wikis/UseCases/Gmail |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 246 | |
Bhaskar Chowdhury | dff2c2e | 2020-02-18 15:10:13 +0530 | [diff] [blame] | 247 | http://www.mutt.org/doc/manual/ |
Eddie Kovsky | 91633a6 | 2015-11-05 23:25:35 -0700 | [diff] [blame] | 248 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 249 | Pine (TUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 250 | ********** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 251 | |
| 252 | Pine has had some whitespace truncation issues in the past, but these |
| 253 | should all be fixed now. |
| 254 | |
| 255 | Use alpine (pine's successor) if you can. |
| 256 | |
| 257 | Config options: |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 258 | |
| 259 | - ``quell-flowed-text`` is needed for recent versions |
| 260 | - the ``no-strip-whitespace-before-send`` option is needed |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 261 | |
| 262 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 263 | Sylpheed (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 264 | ************** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 265 | |
| 266 | - Works well for inlining text (or using attachments). |
| 267 | - Allows use of an external editor. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 268 | - Is slow on large folders. |
| 269 | - Won't do TLS SMTP auth over a non-SSL connection. |
| 270 | - Has a helpful ruler bar in the compose window. |
| 271 | - Adding addresses to address book doesn't understand the display name |
| 272 | properly. |
| 273 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 274 | Thunderbird (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 275 | ***************** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 276 | |
Rob Landley | e0e34e9 | 2011-01-12 17:00:29 -0800 | [diff] [blame] | 277 | Thunderbird is an Outlook clone that likes to mangle text, but there are ways |
| 278 | to coerce it into behaving. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 279 | |
Giedrius Statkevičius | d50ca07 | 2015-03-09 03:53:45 +0200 | [diff] [blame] | 280 | - Allow use of an external editor: |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 281 | The easiest thing to do with Thunderbird and patches is to use an |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 282 | "external editor" extension and then just use your favorite ``$EDITOR`` |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 283 | for reading/merging patches into the body text. To do this, download |
| 284 | and install the extension, then add a button for it using |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 285 | :menuselection:`View-->Toolbars-->Customize...` and finally just click on it |
| 286 | when in the :menuselection:`Compose` dialog. |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 287 | |
Giedrius Statkevičius | d50ca07 | 2015-03-09 03:53:45 +0200 | [diff] [blame] | 288 | Please note that "external editor" requires that your editor must not |
Luis de Bethencourt | a02b4fc | 2015-09-29 14:15:33 +0100 | [diff] [blame] | 289 | fork, or in other words, the editor must not return before closing. |
Giedrius Statkevičius | d50ca07 | 2015-03-09 03:53:45 +0200 | [diff] [blame] | 290 | You may have to pass additional flags or change the settings of your |
| 291 | editor. Most notably if you are using gvim then you must pass the -f |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 292 | option to gvim by putting ``/usr/bin/gvim -f`` (if the binary is in |
| 293 | ``/usr/bin``) to the text editor field in :menuselection:`external editor` |
| 294 | settings. If you are using some other editor then please read its manual |
| 295 | to find out how to do this. |
Giedrius Statkevičius | d50ca07 | 2015-03-09 03:53:45 +0200 | [diff] [blame] | 296 | |
Rob Landley | e0e34e9 | 2011-01-12 17:00:29 -0800 | [diff] [blame] | 297 | To beat some sense out of the internal editor, do this: |
| 298 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 299 | - Edit your Thunderbird config settings so that it won't use ``format=flowed``. |
| 300 | Go to :menuselection:`edit-->preferences-->advanced-->config editor` to bring up |
| 301 | the thunderbird's registry editor. |
Rob Landley | e0e34e9 | 2011-01-12 17:00:29 -0800 | [diff] [blame] | 302 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 303 | - Set ``mailnews.send_plaintext_flowed`` to ``false`` |
Paul Mcquade | 6989b5b | 2011-08-13 12:34:54 -0700 | [diff] [blame] | 304 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 305 | - Set ``mailnews.wraplength`` from ``72`` to ``0`` |
Paul Mcquade | 6989b5b | 2011-08-13 12:34:54 -0700 | [diff] [blame] | 306 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 307 | - :menuselection:`View-->Message Body As-->Plain Text` |
Rob Landley | e0e34e9 | 2011-01-12 17:00:29 -0800 | [diff] [blame] | 308 | |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 309 | - :menuselection:`View-->Character Encoding-->Unicode (UTF-8)` |
Rob Landley | e0e34e9 | 2011-01-12 17:00:29 -0800 | [diff] [blame] | 310 | |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 311 | TkRat (GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 312 | *********** |
Randy Dunlap | a6cd6bf | 2007-10-16 23:29:49 -0700 | [diff] [blame] | 313 | |
| 314 | Works. Use "Insert file..." or external editor. |
| 315 | |
Tim Hockin | 1b6bcdb | 2008-11-06 12:53:33 -0800 | [diff] [blame] | 316 | Gmail (Web GUI) |
Mauro Carvalho Chehab | 06ad636 | 2016-09-21 07:49:18 -0300 | [diff] [blame] | 317 | *************** |
Tim Hockin | 1b6bcdb | 2008-11-06 12:53:33 -0800 | [diff] [blame] | 318 | |
Dave Young | 5ce9f07 | 2010-03-10 15:22:02 -0800 | [diff] [blame] | 319 | Does not work for sending patches. |
Tim Hockin | 1b6bcdb | 2008-11-06 12:53:33 -0800 | [diff] [blame] | 320 | |
Dave Young | 5ce9f07 | 2010-03-10 15:22:02 -0800 | [diff] [blame] | 321 | Gmail web client converts tabs to spaces automatically. |
Tim Hockin | 1b6bcdb | 2008-11-06 12:53:33 -0800 | [diff] [blame] | 322 | |
Dave Young | 5ce9f07 | 2010-03-10 15:22:02 -0800 | [diff] [blame] | 323 | At the same time it wraps lines every 78 chars with CRLF style line breaks |
| 324 | although tab2space problem can be solved with external editor. |
Tim Hockin | 1b6bcdb | 2008-11-06 12:53:33 -0800 | [diff] [blame] | 325 | |
Dave Young | 5ce9f07 | 2010-03-10 15:22:02 -0800 | [diff] [blame] | 326 | Another problem is that Gmail will base64-encode any message that has a |
| 327 | non-ASCII character. That includes things like European names. |