From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 5E0D6138334 for ; Wed, 18 Jul 2018 12:47:26 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 85D4BE08EB; Wed, 18 Jul 2018 12:47:17 +0000 (UTC) Received: from mout.kundenserver.de (mout.kundenserver.de [212.227.126.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id D6367E08DD for ; Wed, 18 Jul 2018 12:47:16 +0000 (UTC) Received: from [192.168.6.88] ([212.159.46.162]) by mrelayeu.kundenserver.de (mreue006 [212.227.15.163]) with ESMTPSA (Nemesis) id 0LiJtA-1gBoIJ0XT2-00cfjy for ; Wed, 18 Jul 2018 14:47:15 +0200 Subject: [RFC] Commit messages - WAS Re: [gentoo-dev] Re: What means bup? To: gentoo-dev@lists.gentoo.org References: <2118089b-4d6d-0a89-ce78-8d5597fb0141@gentoo.org> <20180718072657.fnz45gc44v3m4n6v@gentoo.org> <23374.64477.378910.677336@a1i15.kph.uni-mainz.de> <20180718141045.415fa419@gentoo.org> <02af73dc-824d-4fc1-e9b6-24ced599feb9@gentoo.org> From: "M. J. Everitt" Openpgp: preference=signencrypt Autocrypt: addr=m.j.everitt@iee.org; prefer-encrypt=mutual; keydata= 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 S/3mELhhbHjD5l6T3DV70/Wg8L7qdF4Y Message-ID: Date: Wed, 18 Jul 2018 13:47:03 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 In-Reply-To: <02af73dc-824d-4fc1-e9b6-24ced599feb9@gentoo.org> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="uynBKuFE1LJWtuE6kmTEHkS1uNZnSYcR9" X-Provags-ID: V03:K1:kuURaCYGExh9iMJDHiHOlKtPOJivORkJJoLw7RFmxAiLRR1rmLq BSmL4jjvhRp2AsGWpvT2fukvIZBTFBI6iRUtTzHybSIzcGU4gu3GyFXcNYUYPublO58aOAc X0505e6QI1GYZ77qAZXohOxnqUs0aKtdpr1LU2UxynclkI8npwlbA+HqxlPUdLKjypr8DVx hYTWKpx49Y6Y3n4nbfEtg== X-UI-Out-Filterresults: notjunk:1;V01:K0:X75E0zlk47E=:4IRuYs7QBllm4YLd9Y8I6D pBndk36DOaaG3OjHLBU4wZya2QlzA66vBzaZ165z5invfNwT42wgGxTF12xKNJrlI5uZ4BzFZ l/QFA/5mgCZkBVgcQfkcvDJb9WZRbVfmVTKaDYqY59sI4rIzzIwonRrnIlsJCi73/ZsfjWPYq IKIn7bNsFQ8vNecLlVBEKkb7V3leJhm7N5ZxY+W/1bdmJ6rOIe4r4rDmH/+4XvfKU+p7zpXH5 4nkq+1RWw9sbZvcvoMKg13kKdNIhzcauMIJxLXCQimDNBmZsCMG8Kf4N5K7m7lCcv8XJDdb2g +KjzPheqa8k5qkTOb5FcDZzLqB8v5y45NiBgVSbrmkYtEhR9Q12EryxxNWe1lgKDP9oHYuX0z AlYtA44vqCXTArQcikmhHit4K4BGGI5urUmWau8l04KOXbURo5BhZAoui0q9xTiq1yMfFGkCL hQz/WqW47I3wnUnTgLIMyYc2ZK9QViesLMvpqJjJmWbsTHj635LepPdL6qxg5jsH7h6BA0c6B hvIhzgJNFQOhfJrBdeI9lPkhc4HFX3WPrglAX8vWJa01E36mMchx8TSz2GdlYLj6JgRXELeEl h/+itRVv938mVQoRhUrazaAxkp2RxlPKRSM1ZNPm7so7z/kfN2bS9+C9GLOUiM3JePj58foV8 /l03KXmEuKotBjazK8v3zh/RnOMkJ/ynGeNmyY/qpH0tqvFDnl0Jj1ZHPO99gRF++d5WcQ5Or Qsacpt8rLpKP6t0aeW5musLgUD40Fxplg8E/P4UACCbqRHM37k/DBVjl1zq9XQk5B601B204K oy7tkwi X-Archives-Salt: 2f25678c-d8e5-4b79-b91c-644ee0e4816b X-Archives-Hash: c75fde0d6bd681def8b6e9f2bdc77563 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --uynBKuFE1LJWtuE6kmTEHkS1uNZnSYcR9 Content-Type: multipart/mixed; boundary="6HBejOr4182rsCkKIdIS91LnQAW1uchzN"; protected-headers="v1" From: "M. J. Everitt" To: gentoo-dev@lists.gentoo.org Message-ID: Subject: [RFC] Commit messages - WAS Re: [gentoo-dev] Re: What means bup? References: <2118089b-4d6d-0a89-ce78-8d5597fb0141@gentoo.org> <20180718072657.fnz45gc44v3m4n6v@gentoo.org> <23374.64477.378910.677336@a1i15.kph.uni-mainz.de> <20180718141045.415fa419@gentoo.org> <02af73dc-824d-4fc1-e9b6-24ced599feb9@gentoo.org> In-Reply-To: <02af73dc-824d-4fc1-e9b6-24ced599feb9@gentoo.org> --6HBejOr4182rsCkKIdIS91LnQAW1uchzN Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Content-Language: en-GB On 18/07/18 13:20, Kristian Fiskerstrand wrote: > On 07/18/2018 02:10 PM, Alexis Ballier wrote: >> I often find myself in the >> need to use/invent some abbreviation in order to fit the limit. >> Considering this is an error, this sends the message that short is >> preferred over clear. > Or that the summary should be concise and a longer proper description > can be written in the body of the commit message instead. Potentially > mixed in with multiple commits for different logical changes etc etc. > Perhaps the time has come to re-assess the commit message "standard". I'm thinking something along the lines of the following: - Line one is limited to / and some Key Word that defines the type of change made, similar to bugzilla perhaps eg. "REVBUMP, VERBUMP, EAPIBUMP, BUGFIX, PATCH, FEATUREREQ, OTHER". This would get around the issue of long package-names and/or overlays and other lengthy prefixes. - Line two remains a blank line at present - Line three+ actually describe what the change is, in plain English. - Footer~3: Bug/Pull reference - Footer~2: Signed/Authored/etc standard footer text(s) - Footer: Package manager/repoman as appropriate where: 3+ (line three onwards), ~n: approx. line prior to end (EOF-n) This should satisfy line length limitations, whilst still preserving some Basic information about commit type, which can then be sub-filtered if necessary. I can't presently see anything that would preclude tool-friendly parsing of such messages... or repoman applying appropriate checks... NB. I may have swapped F~3 and F~2 lines around .. order can be preserved as present. --6HBejOr4182rsCkKIdIS91LnQAW1uchzN-- --uynBKuFE1LJWtuE6kmTEHkS1uNZnSYcR9 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEERR5DB4J2baXtk4AVu81GK0wzHTUFAltPNtEACgkQu81GK0wz HTUJZA//S+k6lEkL0oZLSIrsXRnA2nkaoq1e6BcnofkPrxJ7/o1CmQSIw+IgSnuQ orz5OxsgJbaImn5DcZaf7znd1etorm1OrvgY3SCAt2V2XLPqyuIScPRLLVTfxXPt hOYP4eA8Zr/TxcmzIyi5fjC9fOjtBTUcQrczHb7UHPd/bhqyOP8+3PeR1mjziLlv +z9wD6fy7FsKLUkJnKANMx+tMDUuTqx/qDYQpqS/gbh3eC8a6XkBndsQ8HoPpPfd Z9NuU1R7zc52heqFEqpYps6GYfwRq9euMnP0RpFvZ6BnSvp/f5hIczZnh5gapKiJ YR6kDz4PRtSsfrU9qu716Woj3yz+Ccn3YjELFMv8EEIcEqMatSPEnvGD6eHu5jyc ebZ9xN9RFXRbLjd2kGJCSu1YXmhvX4ydV9kkutZKCcVgrMLK+qv+0ls9f6QwgsT+ TSTRMdpkuyqpOy77j5Zfihg1+WpfV81ZElCMbJrKwHKqXJhVgIxxnVFBm44UjaMm atmnVOBrF5Gk33hbh89j7Mg4W/AZUGfXPlo5l9gtVSO5F11Pf+tXp6KFvzumDXj8 l766/2cHZSyuVRWrel4FuSdL3c6BJVQYl3u11py0FBxEOBGkBAR+ydSG4Q2IrvVH x79GqC0Xjadn3QzMJU6CWJJ/NgzB2KKXoqSiqu3aIqWk+LzQcAg= =QcAH -----END PGP SIGNATURE----- --uynBKuFE1LJWtuE6kmTEHkS1uNZnSYcR9--