diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2015-11-13 12:19:05 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2015-11-13 12:19:05 -0500 |
commit | 4aeabc6b5ca3b9d025f287978096e138bdfbdd35 (patch) | |
tree | 7924abba038ffcb4b779ce4007ea53aadf9ea2ab | |
parent | be4773e6a11a0cc1e63c9c32f000b870e51b8c01 (diff) | |
parent | 91633a6dc7cb49ae7c3d268e183ddc905e739fff (diff) |
Merge tag '4.4-additional' of git://git.lwn.net/linux
Pull more documentation updates from Jon Corbet:
"A few more documentation patches that wandered in and have no reason
to wait; these include some improvements to the suggestions for email
clients and patch submission"
* tag '4.4-additional' of git://git.lwn.net/linux:
Documentation: Add minimal Mutt config for using Gmail
Documentation: Add note on sending files directly with Mutt
Documentation: dontdiff: remove media from dontdiff
Documentation/SubmittingPatches: discuss In-Reply-To
Remove email address from Documentation/filesystems/overlayfs.txt
can-doc: Add missing semicolon to example
-rw-r--r-- | Documentation/SubmittingPatches | 15 | ||||
-rw-r--r-- | Documentation/dontdiff | 1 | ||||
-rw-r--r-- | Documentation/email-clients.txt | 36 | ||||
-rw-r--r-- | Documentation/filesystems/overlayfs.txt | 3 | ||||
-rw-r--r-- | Documentation/networking/can.txt | 2 |
5 files changed, 53 insertions, 4 deletions
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches index 4710e4afef19..d603fa078235 100644 --- a/Documentation/SubmittingPatches +++ b/Documentation/SubmittingPatches | |||
@@ -718,8 +718,21 @@ generates appropriate diffstats by default.) | |||
718 | See more details on the proper patch format in the following | 718 | See more details on the proper patch format in the following |
719 | references. | 719 | references. |
720 | 720 | ||
721 | 15) Explicit In-Reply-To headers | ||
722 | -------------------------------- | ||
723 | |||
724 | It can be helpful to manually add In-Reply-To: headers to a patch | ||
725 | (e.g., when using "git send email") to associate the patch with | ||
726 | previous relevant discussion, e.g. to link a bug fix to the email with | ||
727 | the bug report. However, for a multi-patch series, it is generally | ||
728 | best to avoid using In-Reply-To: to link to older versions of the | ||
729 | series. This way multiple versions of the patch don't become an | ||
730 | unmanageable forest of references in email clients. If a link is | ||
731 | helpful, you can use the https://lkml.kernel.org/ redirector (e.g., in | ||
732 | the cover email text) to link to an earlier version of the patch series. | ||
733 | |||
721 | 734 | ||
722 | 15) Sending "git pull" requests | 735 | 16) Sending "git pull" requests |
723 | ------------------------------- | 736 | ------------------------------- |
724 | 737 | ||
725 | If you have a series of patches, it may be most convenient to have the | 738 | If you have a series of patches, it may be most convenient to have the |
diff --git a/Documentation/dontdiff b/Documentation/dontdiff index 9de9813d0ec5..8ea834f6b289 100644 --- a/Documentation/dontdiff +++ b/Documentation/dontdiff | |||
@@ -165,7 +165,6 @@ mach-types.h | |||
165 | machtypes.h | 165 | machtypes.h |
166 | map | 166 | map |
167 | map_hugetlb | 167 | map_hugetlb |
168 | media | ||
169 | mconf | 168 | mconf |
170 | miboot* | 169 | miboot* |
171 | mk_elfconfig | 170 | mk_elfconfig |
diff --git a/Documentation/email-clients.txt b/Documentation/email-clients.txt index aba85b39a400..2d485dea8cec 100644 --- a/Documentation/email-clients.txt +++ b/Documentation/email-clients.txt | |||
@@ -176,11 +176,47 @@ To use 'vim' with mutt: | |||
176 | if you want to include the patch inline. | 176 | if you want to include the patch inline. |
177 | (a)ttach works fine without "set paste". | 177 | (a)ttach works fine without "set paste". |
178 | 178 | ||
179 | You can also generate patches with 'git format-patch' and then use Mutt | ||
180 | to send them: | ||
181 | $ mutt -H 0001-some-bug-fix.patch | ||
182 | |||
179 | Config options: | 183 | Config options: |
180 | It should work with default settings. | 184 | It should work with default settings. |
181 | However, it's a good idea to set the "send_charset" to: | 185 | However, it's a good idea to set the "send_charset" to: |
182 | set send_charset="us-ascii:utf-8" | 186 | set send_charset="us-ascii:utf-8" |
183 | 187 | ||
188 | Mutt is highly customizable. Here is a minimum configuration to start | ||
189 | using Mutt to send patches through Gmail: | ||
190 | |||
191 | # .muttrc | ||
192 | # ================ IMAP ==================== | ||
193 | set imap_user = 'yourusername@gmail.com' | ||
194 | set imap_pass = 'yourpassword' | ||
195 | set spoolfile = imaps://imap.gmail.com/INBOX | ||
196 | set folder = imaps://imap.gmail.com/ | ||
197 | set record="imaps://imap.gmail.com/[Gmail]/Sent Mail" | ||
198 | set postponed="imaps://imap.gmail.com/[Gmail]/Drafts" | ||
199 | set mbox="imaps://imap.gmail.com/[Gmail]/All Mail" | ||
200 | |||
201 | # ================ SMTP ==================== | ||
202 | set smtp_url = "smtp://username@smtp.gmail.com:587/" | ||
203 | set smtp_pass = $imap_pass | ||
204 | set ssl_force_tls = yes # Require encrypted connection | ||
205 | |||
206 | # ================ Composition ==================== | ||
207 | set editor = `echo \$EDITOR` | ||
208 | set edit_headers = yes # See the headers when editing | ||
209 | set charset = UTF-8 # value of $LANG; also fallback for send_charset | ||
210 | # Sender, email address, and sign-off line must match | ||
211 | unset use_domain # because joe@localhost is just embarrassing | ||
212 | set realname = "YOUR NAME" | ||
213 | set from = "username@gmail.com" | ||
214 | set use_from = yes | ||
215 | |||
216 | The Mutt docs have lots more information: | ||
217 | http://dev.mutt.org/trac/wiki/UseCases/Gmail | ||
218 | http://dev.mutt.org/doc/manual.html | ||
219 | |||
184 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 220 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
185 | Pine (TUI) | 221 | Pine (TUI) |
186 | 222 | ||
diff --git a/Documentation/filesystems/overlayfs.txt b/Documentation/filesystems/overlayfs.txt index 6db0e5d1da07..28091457b71a 100644 --- a/Documentation/filesystems/overlayfs.txt +++ b/Documentation/filesystems/overlayfs.txt | |||
@@ -1,4 +1,5 @@ | |||
1 | Written by: Neil Brown <neilb@suse.de> | 1 | Written by: Neil Brown |
2 | Please see MAINTAINERS file for where to send questions. | ||
2 | 3 | ||
3 | Overlay Filesystem | 4 | Overlay Filesystem |
4 | ================== | 5 | ================== |
diff --git a/Documentation/networking/can.txt b/Documentation/networking/can.txt index 4636b94518da..05fd83bb3596 100644 --- a/Documentation/networking/can.txt +++ b/Documentation/networking/can.txt | |||
@@ -681,7 +681,7 @@ solution for a couple of reasons: | |||
681 | addr.can_family = AF_CAN; | 681 | addr.can_family = AF_CAN; |
682 | addr.can_ifindex = ifr.ifr_ifindex; | 682 | addr.can_ifindex = ifr.ifr_ifindex; |
683 | 683 | ||
684 | connect(s, (struct sockaddr *)&addr, sizeof(addr)) | 684 | connect(s, (struct sockaddr *)&addr, sizeof(addr)); |
685 | 685 | ||
686 | (..) | 686 | (..) |
687 | 687 | ||