aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2015-11-13 12:19:05 -0500
committerLinus Torvalds <torvalds@linux-foundation.org>2015-11-13 12:19:05 -0500
commit4aeabc6b5ca3b9d025f287978096e138bdfbdd35 (patch)
tree7924abba038ffcb4b779ce4007ea53aadf9ea2ab
parentbe4773e6a11a0cc1e63c9c32f000b870e51b8c01 (diff)
parent91633a6dc7cb49ae7c3d268e183ddc905e739fff (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/SubmittingPatches15
-rw-r--r--Documentation/dontdiff1
-rw-r--r--Documentation/email-clients.txt36
-rw-r--r--Documentation/filesystems/overlayfs.txt3
-rw-r--r--Documentation/networking/can.txt2
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.)
718See more details on the proper patch format in the following 718See more details on the proper patch format in the following
719references. 719references.
720 720
72115) Explicit In-Reply-To headers
722--------------------------------
723
724It 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
726previous relevant discussion, e.g. to link a bug fix to the email with
727the bug report. However, for a multi-patch series, it is generally
728best to avoid using In-Reply-To: to link to older versions of the
729series. This way multiple versions of the patch don't become an
730unmanageable forest of references in email clients. If a link is
731helpful, you can use the https://lkml.kernel.org/ redirector (e.g., in
732the cover email text) to link to an earlier version of the patch series.
733
721 734
72215) Sending "git pull" requests 73516) Sending "git pull" requests
723------------------------------- 736-------------------------------
724 737
725If you have a series of patches, it may be most convenient to have the 738If 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
165machtypes.h 165machtypes.h
166map 166map
167map_hugetlb 167map_hugetlb
168media
169mconf 168mconf
170miboot* 169miboot*
171mk_elfconfig 170mk_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:
176if you want to include the patch inline. 176if 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
179You can also generate patches with 'git format-patch' and then use Mutt
180to send them:
181 $ mutt -H 0001-some-bug-fix.patch
182
179Config options: 183Config options:
180It should work with default settings. 184It should work with default settings.
181However, it's a good idea to set the "send_charset" to: 185However, 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
188Mutt is highly customizable. Here is a minimum configuration to start
189using Mutt to send patches through Gmail:
190
191# .muttrc
192# ================ IMAP ====================
193set imap_user = 'yourusername@gmail.com'
194set imap_pass = 'yourpassword'
195set spoolfile = imaps://imap.gmail.com/INBOX
196set folder = imaps://imap.gmail.com/
197set record="imaps://imap.gmail.com/[Gmail]/Sent Mail"
198set postponed="imaps://imap.gmail.com/[Gmail]/Drafts"
199set mbox="imaps://imap.gmail.com/[Gmail]/All Mail"
200
201# ================ SMTP ====================
202set smtp_url = "smtp://username@smtp.gmail.com:587/"
203set smtp_pass = $imap_pass
204set ssl_force_tls = yes # Require encrypted connection
205
206# ================ Composition ====================
207set editor = `echo \$EDITOR`
208set edit_headers = yes # See the headers when editing
209set charset = UTF-8 # value of $LANG; also fallback for send_charset
210# Sender, email address, and sign-off line must match
211unset use_domain # because joe@localhost is just embarrassing
212set realname = "YOUR NAME"
213set from = "username@gmail.com"
214set use_from = yes
215
216The 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~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
185Pine (TUI) 221Pine (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 @@
1Written by: Neil Brown <neilb@suse.de> 1Written by: Neil Brown
2Please see MAINTAINERS file for where to send questions.
2 3
3Overlay Filesystem 4Overlay 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