Re: git: bb8dbe1580ae - main - sysutils/lnav: Fix distinfo

From: Yasuhiro Kimura <yasu_at_utahime.org>
Date: Wed, 17 Nov 2021 03:44:52 UTC
From: Alexey Dokuchaev <danfe@freebsd.org>
Subject: Re: git: bb8dbe1580ae - main - sysutils/lnav: Fix distinfo
Date: Wed, 17 Nov 2021 03:24:47 +0000

> I know you prefer DISTVERSION by default for some obscure reason, but
> changing just the knob spelling without actual version number is what
> we call gratuitous change and something we try to avoid as it clobbers
> the history, thus pessimizing code archaeology process, and decreases
> commit diff SNR.

It's not just my personal preference. Section of 5.2.2 of Porter's
Handbook says as following.

"Set DISTVERSION to the version number of the software.

PORTVERSION is the version used for the FreeBSD package. It will be
automatically derived from DISTVERSION to be compatible with
FreeBSD’s package versioning scheme. If the version contains letters,
it might be needed to set PORTVERSION and not DISTVERSION."

https://docs.freebsd.org/en/books/porters-handbook/makefiles/#makefile-versions

---
Yasuhiro Kimura