Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1161478AbbKFN5U (ORCPT ); Fri, 6 Nov 2015 08:57:20 -0500 Received: from mail-wm0-f50.google.com ([74.125.82.50]:38009 "EHLO mail-wm0-f50.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1161289AbbKFN5S (ORCPT ); Fri, 6 Nov 2015 08:57:18 -0500 Date: Fri, 6 Nov 2015 14:57:14 +0100 From: Frederic Weisbecker To: Chris Metcalf Cc: Steven Rostedt , Jonathan Corbet , Peter Zijlstra , Gilad Ben Yossef , Ingo Molnar , Andrew Morton , Rik van Riel , Tejun Heo , Thomas Gleixner , "Paul E. McKenney" , Christoph Lameter , Viresh Kumar , Catalin Marinas , Will Deacon , Andy Lutomirski , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Subject: Re: [PATCH v2] Documentation/SubmittingPatches: discuss In-Reply-To Message-ID: <20151106135713.GA14071@lerouge> References: <20151105142335.52ce33bc@gandalf.local.home> <1446754907-29641-1-git-send-email-cmetcalf@ezchip.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1446754907-29641-1-git-send-email-cmetcalf@ezchip.com> User-Agent: Mutt/1.5.24 (2015-08-30) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1734 Lines: 43 On Thu, Nov 05, 2015 at 03:21:47PM -0500, Chris Metcalf wrote: > Add a paragraph suggesting best practices for when to link patches > to previous LKML messages via In-Reply-To. > > Signed-off-by: Chris Metcalf ACK! Thanks! > --- > Documentation/SubmittingPatches | 10 ++++++++++ > 1 file changed, 10 insertions(+) > > diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches > index fd89b04d34f0..9f61620f34ef 100644 > --- a/Documentation/SubmittingPatches > +++ b/Documentation/SubmittingPatches > @@ -675,6 +675,16 @@ A couple of example Subjects: > Subject: [patch 2/5] ext2: improve scalability of bitmap searching > Subject: [PATCHv2 001/207] x86: fix eflags tracking > > +It can be helpful to manually add In-Reply-To: headers to a patch > +(e.g., when using "git send email") to associate the patch with > +previous relevant discussion, e.g. to link a bug fix to the email with > +the bug report. However, 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 the https://lkml.kernel.org/ redirector (e.g., in > +the cover email text) to link to an earlier version of the patch series. > + > The "from" line must be the very first line in the message body, > and has the form: > > -- > 2.1.2 > -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/