From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <gentoo-commits+bounces-681792-garchives=archives.gentoo.org@lists.gentoo.org> Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 8BFD81387FD for <garchives@archives.gentoo.org>; Sun, 30 Mar 2014 00:22:53 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 9D30DE0A02; Sun, 30 Mar 2014 00:22:52 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id E8E85E0A03 for <gentoo-commits@lists.gentoo.org>; Sun, 30 Mar 2014 00:22:51 +0000 (UTC) Received: from spoonbill.gentoo.org (spoonbill.gentoo.org [81.93.255.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 29EEA33FD92 for <gentoo-commits@lists.gentoo.org>; Sun, 30 Mar 2014 00:22:51 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by spoonbill.gentoo.org (Postfix) with ESMTP id EC5B8188F4 for <gentoo-commits@lists.gentoo.org>; Sun, 30 Mar 2014 00:22:49 +0000 (UTC) From: "Alexander Berntsen" <bernalex@gentoo.org> To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Alexander Berntsen" <bernalex@gentoo.org> Message-ID: <1396051264.8e3e0ac212a3847638c83edc1b752dadbfd5cd9d.bernalex@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: / X-VCS-Repository: proj/portage X-VCS-Files: DEVELOPING X-VCS-Directories: / X-VCS-Committer: bernalex X-VCS-Committer-Name: Alexander Berntsen X-VCS-Revision: 8e3e0ac212a3847638c83edc1b752dadbfd5cd9d X-VCS-Branch: master Date: Sun, 30 Mar 2014 00:22:49 +0000 (UTC) Precedence: bulk List-Post: <mailto:gentoo-commits@lists.gentoo.org> List-Help: <mailto:gentoo-commits+help@lists.gentoo.org> List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org> List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org> List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org> X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 87b156ca-284d-4343-ba54-a9aad356c3b5 X-Archives-Hash: d9346cadbeae53c26e2ce5d7af99712d commit: 8e3e0ac212a3847638c83edc1b752dadbfd5cd9d Author: Alexander Berntsen <bernalex <AT> gentoo <DOT> org> AuthorDate: Thu Mar 27 12:42:33 2014 +0000 Commit: Alexander Berntsen <bernalex <AT> gentoo <DOT> org> CommitDate: Sat Mar 29 00:01:04 2014 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=8e3e0ac2 DEVELOPING: Add note on commit messages --- DEVELOPING | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/DEVELOPING b/DEVELOPING index 9731610..cfa86a6 100644 --- a/DEVELOPING +++ b/DEVELOPING @@ -175,6 +175,26 @@ change a lot of unrelated things. This makes it easier to see what parts of the system have actually changed. It also makes it easier to cherry-pick and revert commits. Use your common sense! +Commit messages +--------------- + +Commit messages should be in the imperative mood with a capitalised +header, optionally followed by a newline and a more detailed explanatory +text. The headline should be capped at 50 characters, the detailed text +at 72. Prefix the message with the component you touched if this makes +sense. Postfix the message with the bug it fixes, if it does. Example: + +" +emerge: Fix --tree output (bug 555555) + +Make sure newlines appear where they are supposed to. Fix a bug with +colourisation of --tree output when used in tandem with --verbose +--pretend --ask. +" + +For a more detailed explanation (and rationalisation) of these rules: +<http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html> + Releases --------