Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 07 Apr 2021 11:35:31 +0200
From:      Adriaan de Groot <adridg@freebsd.org>
To:        ports-committers@freebsd.org, dev-commits-ports-all@freebsd.org, dev-commits-ports-main@freebsd.org
Subject:   Please use portname in first line of git commit message
Message-ID:  <2308633.THHZn3L5Ee@beastie.bionicmutton.org>
In-Reply-To: <202104070848.1378mMfS074380@gitrepo.freebsd.org>

index | next in thread | previous in thread | raw e-mail

[-- Attachment #1 --]
Not picking on Wen Heping, but purely as an example, here's a commit message 
from today, with the email subject:

On Wednesday, 7 April 2021 10:48:22 CEST Wen Heping wrote:
> git: 8a7bd1522fcd - main - - Update to 3.3.2

In the before times, that would might have looked something like this:

> svn commit: r569270 - head/audio/zynaddsubfx

The git email doesn't know what paths have been committed, and "just" uses the 
first line of the commit message. Many people now use

<category>/<port>: <change summary>

as the first line of the commit message, also because "git log" doesn't show 
files by default, and convenient git-history viewers like gitk and qgit show 
the first line. Using this format for the first line of a commit message 
(followed by one blank line) helps all consumers of the git tree -- you can 
spot a couple by me that do *not* follow this format as well, that was before 
I realised that "this can be better".

[ade]
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----

iQGzBAABCAAdFiEEhrjttu2OP5apuuy1z93JbxKxkVwFAmBtfOMACgkQz93JbxKx
kVyURgv+Jsx1LQWzeP4v/Tx9MikT+g1kV8Vtr5oELVHyOKhGN/OicA68mxfU1F79
9qJnRnYZ3tvSEWxXrhCbBwRoZ3kKZw2y2auZuKDFWScwOoks9EmrFGxuxwiMrhCW
UwYnR+9PB+EvS5sZ1/5w+J/2btYyzRUIElS3pHoCygb7yBY4/bawwpQnShdVwWmk
91Uf+9OkUQWEDLiUA2JUZEyRWq9Pz7/VHsv++CaDEpQ829rVkyyHM0fbCMsDI6dn
KJfb0iaxmR8GDcq2ckFCqVMAFXH7axY1igxzXWppYmIvlmhq8sj5Vrq5LbYXEm6h
myNVwzqPBCmmWF1j2wjZAbaYUyZ5mTf/Ag/EkNLdvcZOfCOL3yBu9UdrVHN1dqK5
kEfu1okvn5u/xn1KTDYoFNHI7WlU+8JE8x1QT5V6v8QhfI84M8hxaMmLhcPKSfpN
9l8x1jGUKxaFoq1tK2aNE7KRAi205N1FyyWPyqtXrshzHyiGtCKz5kOImeb0wZhz
Dtrxa83x
=cAi/
-----END PGP SIGNATURE-----
home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?2308633.THHZn3L5Ee>