hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/process/email-clients.rst
....@@ -25,6 +25,11 @@
2525 it makes quoting portions of the patch more difficult in the patch
2626 review process.
2727
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
+
2833 Email clients that are used for Linux kernel patches should send the
2934 patch text untouched. For example, they should not modify or delete tabs
3035 or spaces, even at the beginning or end of lines.
....@@ -40,7 +45,7 @@
4045 If you configure your email client to send emails with UTF-8 encoding,
4146 you avoid some possible charset problems.
4247
43
-Email clients should generate and maintain References: or In-Reply-To:
48
+Email clients should generate and maintain "References:" or "In-Reply-To:"
4449 headers so that mail threading is not broken.
4550
4651 Copy-and-paste (or cut-and-paste) usually does not work for patches
....@@ -89,7 +94,7 @@
8994
9095 Works. Some people use this successfully for patches.
9196
92
-To insert a patch use :menuselection:`Message-->Insert` File (:kbd:`CTRL-I`)
97
+To insert a patch use :menuselection:`Message-->Insert File` (:kbd:`CTRL-I`)
9398 or an external editor.
9499
95100 If the inserted patch has to be edited in the Claws composition window
....@@ -132,8 +137,8 @@
132137 At the bottom of your email, put the commonly-used patch delimiter before
133138 inserting your patch: three hyphens (``---``).
134139
135
-Then from the :menuselection:`Message` menu item, select insert file and
136
-choose your patch.
140
+Then from the :menuselection:`Message` menu item, select
141
+:menuselection:`insert file` and choose your patch.
137142 As an added bonus you can customise the message creation toolbar menu
138143 and put the :menuselection:`insert file` icon there.
139144
....@@ -149,18 +154,16 @@
149154 as inlined text will make them tricky to extract from their 7-bit encoding.
150155
151156 If you absolutely must send patches as attachments instead of inlining
152
-them as text, right click on the attachment and select properties, and
153
-highlight :menuselection:`Suggest automatic display` to make the attachment
157
+them as text, right click on the attachment and select :menuselection:`properties`,
158
+and highlight :menuselection:`Suggest automatic display` to make the attachment
154159 inlined to make it more viewable.
155160
156161 When saving patches that are sent as inlined text, select the email that
157162 contains the patch from the message list pane, right click and select
158163 :menuselection:`save as`. You can use the whole email unmodified as a patch
159
-if it was properly composed. There is no option currently to save the email
160
-when you are actually viewing it in its own window -- there has been a request
161
-filed at kmail's bugzilla and hopefully this will be addressed. Emails are
162
-saved as read-write for user only so you will have to chmod them to make them
163
-group and world readable if you copy them elsewhere.
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.
164167
165168 Lotus Notes (GUI)
166169 *****************
....@@ -239,9 +242,9 @@
239242
240243 The Mutt docs have lots more information:
241244
242
- http://dev.mutt.org/trac/wiki/UseCases/Gmail
245
+ https://gitlab.com/muttmua/mutt/-/wikis/UseCases/Gmail
243246
244
- http://dev.mutt.org/doc/manual.html
247
+ http://www.mutt.org/doc/manual/
245248
246249 Pine (TUI)
247250 **********