From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752604AbbJWQNU (ORCPT ); Fri, 23 Oct 2015 12:13:20 -0400 Received: from mail-am1on0082.outbound.protection.outlook.com ([157.56.112.82]:14996 "EHLO emea01-am1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751167AbbJWQNR (ORCPT ); Fri, 23 Oct 2015 12:13:17 -0400 Authentication-Results: spf=fail (sender IP is 12.216.194.146) smtp.mailfrom=ezchip.com; ezchip.com; dkim=none (message not signed) header.d=none;ezchip.com; dmarc=none action=none header.from=ezchip.com; From: Chris Metcalf To: Peter Zijlstra , Gilad Ben Yossef , Steven Rostedt , Ingo Molnar , Andrew Morton , Rik van Riel , Tejun Heo , Frederic Weisbecker , Thomas Gleixner , "Paul E. McKenney" , Christoph Lameter , Viresh Kumar , Catalin Marinas , Will Deacon , Andy Lutomirski , , Jonathan Corbet , CC: Chris Metcalf Subject: [PATCH] Documentation/email-clients.txt: discuss In-Reply-To Date: Fri, 23 Oct 2015 12:13:01 -0400 Message-ID: <1445616781-8212-1-git-send-email-cmetcalf@ezchip.com> X-Mailer: git-send-email 2.1.2 X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;DB3FFO11FD044;1:mFsZnMfJ0Zgavvi9fMv7ZvrqPSb9HP/BxVTmsxU4xr93OFmnefCHYzmSbFwT/SBztg5bGBnRO+mAymjrbgM74PkPpMPZqNZsZMKYoxELKtc9bIV0IJIlpNz/NRLwfhqSEoJnaF8/p5XP7rhSYTPy7ePSzSWdVqOJz6zvyaOn9rnFUkBa52etje/cOmJJnTkFjzIxMeBc3u9grageSDj9MYIsSSmdcUlDFmfQ7TixnaVN5IykBNcqw54Wcv4qxlEICaoPLXxfqMnmohnKFKc4vHCHSGX8Asq1kIpI9DB11S2Qa02OcEeGYDEiTctU4cGeYuxoROhELDxhVmL5tVr/X/W1TZheO8pLJk/ETocDDNygzqfIDkS+DQe6fnbFd75fNkpHLUxl/ot+GEmRK3kVcg== X-Forefront-Antispam-Report: CIP:12.216.194.146;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(979002)(6009001)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(92566002)(15975445007)(5008740100001)(42186005)(86362001)(105606002)(36756003)(33646002)(50986999)(106356001)(230783001)(50226001)(104016004)(85426001)(47776003)(5001920100001)(5007970100001)(19580405001)(6806005)(97736004)(5001770100001)(106476002)(11100500001)(48376002)(229853001)(107886002)(5001960100002)(189998001)(5003940100001)(87936001)(106466001)(50466002)(81156007)(19580395003)(9376005)(921003)(2101003)(4001430100001)(83996005)(1121003)(969003)(989001)(999001)(1009001)(1019001);DIR:OUT;SFP:1101;SCL:1;SRVR:AM3PR02MB0423;H:ld-1.internal.tilera.com;FPR:;SPF:Fail;PTR:InfoNoRecords;MX:1;A:1;LANG:en; MIME-Version: 1.0 Content-Type: text/plain X-Microsoft-Exchange-Diagnostics: 1;AM3PR02MB0423;2:2aE1j74GdtmaTJC+RjD2rjWaal0+/zUt7iZzahKq/CLRPlsVqqbvWODo8cMie422CJIHovQYdwVeoDUTVmPPYPzYq03KDFUt0tyR8kI4/XBZxwPOI0G5WXGi5MnBqkGkHtuv09+ZRp+hexjup+NjlBpsXMOMB/WEQfaXg3fZdWU=;3:a5T4zsVcQwAF8ZIXfalauNtRImQTXRLwhmwdQuXeDb4Rv0fjv2YaLwOwvNFIzoXOk/eFGAF6u1pFKwWJVrqDDHcbT7mysH3HFG4RpFeWDhf5hcLysuqb/Zwxg3j2BcMZTdhE5JgsTej9YXcVoCECkBrdiRXSU+ifuYHMfSbJD2u+E/SV8Trd5vJR6GOcpURD11k5P+o6XaKx91Od8OkAmGLCg4W2NKBH4aFLFWWArvfgSoILCZNx4BASVABPqzgZ;25:Isv3ZjgHlk6KIDWmMk5NZXq9ydPrk/PKlXiIRiw2DN3yCg4Myt1Zrt/jHWMzRQ2Fwn26Bspkn6x4SulNYvyjQCBgbfedBXse4CikMT8j6IJCMUu3Ubkwq/n27SPCfzVwGk3Z/wjHKNVeZKBL6y03R8oLabEqAsH8sueNzIVAW4MI8eY8Nv2w4siSXVoYlRpvma7r7v1BiAH+nu3hbglOMUoOscA2Kblz+E1BxlMtxJvhscPUj0+9GNx6zj0VWIGyXeQLzmw1ZBte8MwLP+unYA==;20:mbOEmy9NhIRamLKRGIwRy34mE/USyE6n/1Sz/v/Qo+Go8Gvvq643K2EWz4ZmJugVzGn6Lby8hIZMuVkbtEuqRTqIWYCgoWlNqCM50MynkRtAbNwAcA6vnQe72idBA/Ge8zFppXZzVJF9va39tmYHF6uzNzpnFNVK3uOZODiKH3E= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:AM3PR02MB0423; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(121898900299872); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(2401047)(520078)(5005006)(8121501046)(3002001)(102215026);SRVR:AM3PR02MB0423;BCL:0;PCL:0;RULEID:;SRVR:AM3PR02MB0423; X-Microsoft-Exchange-Diagnostics: 1;AM3PR02MB0423;4:WHz+M1cyVQ30kLAn7x0iemD2dA/WvXLxZSY5cN68XPUlMsiR4GdApWvAkcHV+ehPD1rwanm39tzAdi3HnSYrjTei5jHnLYiDlNnZebQ+yu75ACTcqcpiFUPCcW6FPXc1v74Y9fylEcOO/z5ox/KE8xdAZJzJbVHV1NfYyXByxgxTflrMpqDRpbTjEO4sBj083IuX2zk4F3sq7tYVigM5gUl5XtC1uvYFyIjLmhiSdbLSuPJhuuZB0goNDfwhmW3Mz86GcLA53cscr1+yFXL75ADgBP+w9XkpT2kLTwGKcD1po3jl03KspDY4g0RHIdjAepQi8qwe6nRB9QKnceefvbdCpU7l+7YpgGndBZqK4D/mkFCmM/dCMVLxr+01jYFQ X-Forefront-PRVS: 0738AF4208 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;AM3PR02MB0423;23:pNx1il5MKLMj6xad2BeTiiG6cb5esxnTTW8rPT62G?= =?us-ascii?Q?JfWFWhD1TR2ZM+/x4AJ79GEqcRm1ui0E5pgtN2ruVZnGtcsaFnx5FeS2Ziwk?= =?us-ascii?Q?7I8mi5cjm7SVw+baSOWXHW4uN75D0uqmKdJP457wAm9hXOKlx3pQhMyo2Qj2?= =?us-ascii?Q?L/1AbypVefzqisE1cRJ4bqrbaHwE7jWdet6UUQ/8QmYClC7HtC/jPqrpQM3g?= =?us-ascii?Q?7Ms7c4smN0vhAlyGFZYS1bMj6dlBxYVaAUSxi7TktXvQx884bB3rEaF/moug?= =?us-ascii?Q?FV/CrVtf7ZepKBiJy0fs8tUcT8vvyI2XSZPsGWHLhjei1mOmLlDRICDl2FiM?= =?us-ascii?Q?LrVWDODm8JJhNpCcy9YR0qeMnH8X+8mXycFZm81Vd9PqCQPsNEiSO/woODlV?= =?us-ascii?Q?jLGeIuzeg9tCOb9Vx9FY0ZMzGEbxC1NOKSOYh0RqhO6ad0Gv1UAdJPMovGLJ?= =?us-ascii?Q?bDV4G45MBP/dLR58CgCee1WAcO5Hkq480T0/EIP32re/LfvnbQY7zQPWy0sA?= =?us-ascii?Q?KCq3WQ6QbSXiOLxtOlJPZ1A1pevmVCq1M0jYiJ3PCqWYvZoM0HLZRB7T9w3H?= =?us-ascii?Q?EgWEl3cJdoRcXCn2Wjsm1l+nnqPB4C1P1uzKr80OAUkJq+uY0yy9go16MxtL?= =?us-ascii?Q?AG5QFM7kJSLRsy4je+0ujSMUpc2zFb7KwkM0Vb3TSUzg1gUJAEdQKOZoYPEr?= =?us-ascii?Q?b0qF0rqC7TN2VX+ZeplwjbZeIGfp7ZMBb3RS+9uAna/LIAJfvDJGVtvzYcm6?= =?us-ascii?Q?kt1XERQcsHgWTNn1sWLCBJznNi1FJaZCI4vTcioWMv59qV/hzdQdsNWwoRqX?= =?us-ascii?Q?492ctoZaW0Jn40yv0M8zvehVwnFKnCyTxkxeZybLPPp/rEvjA7v18XSSIEpq?= =?us-ascii?Q?TZ9oITuCVcHrNJk+6JKTIDjj6Zs/I1suXZ+nI0XWmXRbHxf4oMtBH+jMxAbk?= =?us-ascii?Q?dEDEIptNpv7n73AECYQZU9uttVhmRFaDNExLDRN24xEXdI0d3e76Ddc4Fozh?= =?us-ascii?Q?c2406m6KThXjGRpUd6qf2BGYFXVe+djNyWTZMZ0QuvuycXyTuFI/OT4SyB98?= =?us-ascii?Q?vq8K1ClFK67de15QlMfGK3Gv1/Nlyb9juHk6unQOUa/K8IKO0V/pZGEBE8Iv?= =?us-ascii?Q?wh6ls+G3SC+MMribhF3qhXtMPBTXqA3eHZZBrP5PZG1MKwuFg30cUbiBki80?= =?us-ascii?Q?QrWGDnJT60Xq89zqO1oaU68+BUxaKcZc266BnXCbwVRtqLthElMcduVn/7Dq?= =?us-ascii?Q?/B52iQfv2noaFXk09G18Zw9OPjeC2RziCLEK9qL0kl1QQe2DXalCkNgiTWcp?= =?us-ascii?Q?zA9J4Z7EJgbsvoV2tTQHwPGxLvmVGG27Hbl6iDGXWXFvcocTfAantsL5PW/j?= =?us-ascii?Q?915bA=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;AM3PR02MB0423;5:WFoPeY2KK0P1K0fTKaO41nvKqByA+aJiLjzb3UlGhGoZC09aNXc142gygQGkp27vMafBK5WmRDcCtvcjGtAzjUAeXS3EbRH0ISX863wyJG7Fr4yHu0BeGPYqZztk6ZfSI/KRyfDPiSlZIlOc9/S2Mw==;24:5IhCOBBrXy6HHBE5jPvs+jl2VEPRbZ7fOhfgebC2kuGO0+9NAYdJYd/KrCOv9Q5WzZbc/zfKpVr7QpFzQ3Rnff8awnlac/kjQ7W0pv0klfA=;20:GIESgGVWPbq3hGn/Ustjur6BQ8zHKC3RO7q33+y8d+CbvoLQnJ/T1W5PMCmzmmECHHvrPWvFZ4jUdclLyC3s6Q== SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: ezchip.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Oct 2015 16:13:12.0921 (UTC) X-MS-Exchange-CrossTenant-Id: 0fc16e0a-3cd3-4092-8b2f-0a42cff122c3 X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=0fc16e0a-3cd3-4092-8b2f-0a42cff122c3;Ip=[12.216.194.146];Helo=[ld-1.internal.tilera.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM3PR02MB0423 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org In-Reply-To: <20151023090459.GW17308@twins.programming.kicks-ass.net> This commit adds a paragraph suggesting best practices for when to link patches to previous LKML messages via In-Reply-To. Signed-off-by: Chris Metcalf --- Documentation/email-clients.txt | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/email-clients.txt b/Documentation/email-clients.txt index 3fa450881ecb..547c54a2f4e0 100644 --- a/Documentation/email-clients.txt +++ b/Documentation/email-clients.txt @@ -39,6 +39,16 @@ you avoid some possible charset problems. Email clients should generate and maintain References: or In-Reply-To: headers so that mail threading is not broken. +When manually adding In-Reply-To: headers to a patch (e.g., using `git +send email`), use common sense to associate the patch with previous +relevant discussion, e.g. link a bug fix to the email with the bug report. +For a multi-patch series, it is generally best to avoid using +In-Reply-To: to link to older versions of the series. This way +multiple versions of the patch don't become an unmanageable forest of +references in email clients. If a link is helpful, you can use an +"http://lkml.kernel.org/r/MESSAGEID" URL (e.g., in the cover email +text) to link to an earlier version of the patch series. + Copy-and-paste (or cut-and-paste) usually does not work for patches because tabs are converted to spaces. Using xclipboard, xclip, and/or xcutsel may work, but it's best to test this for yourself or just avoid -- 2.1.2