From patchwork Wed Mar 5 16:24:33 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas De Schampheleire X-Patchwork-Id: 327076 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from hemlock.osuosl.org (hemlock.osuosl.org [140.211.166.133]) by ozlabs.org (Postfix) with ESMTP id 926912C00BD for ; Thu, 6 Mar 2014 03:29:02 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id AF8C19588F; Wed, 5 Mar 2014 16:28:51 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id oD7RRetX3wCL; Wed, 5 Mar 2014 16:28:50 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by hemlock.osuosl.org (Postfix) with ESMTP id DB11795CA8; Wed, 5 Mar 2014 16:28:49 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 88FA41BF95D for ; Wed, 5 Mar 2014 16:28:48 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 854A689632 for ; Wed, 5 Mar 2014 16:28:48 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ZPbk0UN1htr6 for ; Wed, 5 Mar 2014 16:28:48 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-ea0-f176.google.com (mail-ea0-f176.google.com [209.85.215.176]) by whitealder.osuosl.org (Postfix) with ESMTPS id B0ECA8916F for ; Wed, 5 Mar 2014 16:28:47 +0000 (UTC) Received: by mail-ea0-f176.google.com with SMTP id o10so1151874eaj.7 for ; Wed, 05 Mar 2014 08:28:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=content-type:mime-version:content-transfer-encoding:subject :message-id:in-reply-to:references:user-agent:date:from:to; bh=0awbQLMgd/qZzslwwAvhbJFPAU5qRBKv8BDo8c2Fe1A=; b=FMc0X+cFRsGlvbxaNrmf59fs5ajY2W7aVfmr0h3g+bM3ezzpyqCZWi0YUQYj3vwiou gX0Uw5y2KMebrDU8jxcurDY4vCft6FwOnqX3inBR7qpLsNylBldgVpPQUwL4jiLZ+rFy 8TSVC1XIEtapIjCFeQ+YSLE32F4z2OHZjyxNT9WFlKO3AtaNajxLJAuYR63j+JCYhHDL RptxQ5UZc3UD2D0am8+7r09CEnvBX3cxyxkMRqgxDMzC6Sh3iMn6x7Vyj0wjMgM/WwxO KN7rWuqWrGv9N1drxD4CmXePz/WdIoz02hvl74EFdMzdrkdpbOOjFer2TQ7zr9Ipa2Ws SwpQ== X-Received: by 10.15.82.6 with SMTP id z6mr6805679eey.48.1394036926307; Wed, 05 Mar 2014 08:28:46 -0800 (PST) Received: from [127.0.1.1] (d54C62EEB.access.telenet.be. [84.198.46.235]) by mx.google.com with ESMTPSA id 54sm10942999eek.19.2014.03.05.08.28.44 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 05 Mar 2014 08:28:44 -0800 (PST) MIME-Version: 1.0 X-Mercurial-Node: e95d3b84bcc4048fed60a2e1432e9eb533371c87 Message-Id: In-Reply-To: References: User-Agent: Mercurial-patchbomb/2.2.2 Date: Wed, 05 Mar 2014 17:24:33 +0100 From: Thomas De Schampheleire To: buildroot@buildroot.org Subject: [Buildroot] [PATCH 7 of 8] manual: contributing: don't recommend leaving out changelog from patches X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net Currently, the manual states that if you send a series and include a changelog in the introduction mail (0 of x), it is not necessary to include a changelog on the individual patches. I don't like this: for large patch series it requires going back to the introduction mail when opening each patch, to understand what changed. This patch rewords the paragraph accordingly. Signed-off-by: Thomas De Schampheleire --- docs/manual/contribute.txt | 4 ++-- 1 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/manual/contribute.txt b/docs/manual/contribute.txt --- a/docs/manual/contribute.txt +++ b/docs/manual/contribute.txt @@ -220,8 +220,8 @@ Patch revision changelog When improvements are requested, the new revision of each commit should include a changelog of the modifications between each submission. Note that when your patch series is introduced by a cover -letter, the changelog may be added in the cover letter rather than in -the individual commits. +letter, an overall changelog may be added to the cover letter in +addition to the changelog in the individual commits. When added to the individual commits, this changelog is added when editing the commit message. Below the +Signed-off-by+ section, add