Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 28 Apr 2021 12:36:39 +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, Alexey Dokuchaev <danfe@freebsd.org>
Subject:   Please use conventional commit messages (Re: git: 2a9b7ca2a362)
Message-ID:  <2794032.slGk94SIus@beastie.bionicmutton.org>
In-Reply-To: <202104281017.13SAHDF2019723@gitrepo.freebsd.org>

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

[-- Attachment #1 --]
On Wednesday, 28 April 2021 12:17:13 CEST Alexey Dokuchaev wrote:
> commit 2a9b7ca2a3620249bfad050ac3eee6d859926213
> Author:     Alexey Dokuchaev <danfe@FreeBSD.org>
> AuthorDate: 2021-04-28 10:16:16 +0000
> Commit:     Alexey Dokuchaev <danfe@FreeBSD.org>
> CommitDate: 2021-04-28 10:16:32 +0000
> 
>     Update `www/web2ldap' to version 1.5.117.

Please use conventional commit messages, for consistency with the rest of the 
ports commits and convenience for consumers -- humans looking at commits 
through tools like email, qgit and gitk (desktop-applications), cgit (git-web 
browser) and git log (CLI).

The conventional format for commit messages in git overall is:

<summary-what>
<blank line>
<explanation>

For FreeBSD, this is slightly more specific, and the conventional format is 
(with a bunch of details I'm ommitting here in this friendly reminder):

<category>/<portname>: <what>
<blank line>
<explanation>

You can configure a git-commit hook to help remind you of the conventional 
format; this can be done on a per-repository basis if you work on multiple 
repositories with differing social conventions.

Recent discussions of commit-message formatting may be found on the ports 
list, including threads "New port: regather is an LDAP syncrepl consumer which 
can perform various actions based on LDAP syncrepl events." and "[HEADSUP] git 
hooks" and "Ports tree have been migrated to git".

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

iQGzBAABCAAdFiEEhrjttu2OP5apuuy1z93JbxKxkVwFAmCJOrcACgkQz93JbxKx
kVwchQv5ATUk+iIQxoGj3C1fnIwEuV7gRlv8ccq48yCYxeEAsEFRHpl+4tPtQugL
1W1b2jUldXxE7wo2pI9edwasa8K7Bw+nPytBHE2/cTx0mZZrm38ZcEtiOCYoTfrM
gcWPRcg6V35sXbNmYmSnXm2scw5l+9Ztx02uqEBsLimkW/Sb+HQ3rZ/MBPUlup71
vaNgVo0Cs7i+zMO3GPdEk8TOv1CU0tYy21HoRPtM2KKIb9mMUGFwZL4BSybhLAf6
nlzUCA04+aUQoUbgBaQgphMOmNCdGQ78gPcXf5QALSlYwvgZJvVuRggQla3kml0E
Esl2WMbVE6qt8F07wtYZeS5N1PDM1d2XdghArD6BScZLF37YMNMK28s8tgSLBnxG
6yEnN0jALxOTZhB646Sdgm4ccExhsW9OPa5MR0OnnBX2hfmci1mc9v/k9T1xAar6
pXa2atdjDgsUlNmyL32GBbMf6xpSxh29yP6X8Pl8Q+RjQaIYV+oX5QB5VytO41pj
APdxY+0y
=qOnP
-----END PGP SIGNATURE-----
home | help

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