From owner-freebsd-current@freebsd.org  Mon Apr 19 07:27:38 2021
Return-Path: <owner-freebsd-current@freebsd.org>
Delivered-To: freebsd-current@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id D71325E4FFD
 for <freebsd-current@mailman.nyi.freebsd.org>;
 Mon, 19 Apr 2021 07:27:38 +0000 (UTC) (envelope-from bapt@nours.eu)
Received: from mailman.nyi.freebsd.org (mailman.nyi.freebsd.org
 [IPv6:2610:1c1:1:606c::50:13])
 by mx1.freebsd.org (Postfix) with ESMTP id 4FNz164GCcz3JZq
 for <freebsd-current@freebsd.org>; Mon, 19 Apr 2021 07:27:38 +0000 (UTC)
 (envelope-from bapt@nours.eu)
Received: by mailman.nyi.freebsd.org (Postfix)
 id 902E95E55A1; Mon, 19 Apr 2021 07:27:38 +0000 (UTC)
Delivered-To: current@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id 8FFA75E55A0
 for <current@mailman.nyi.freebsd.org>; Mon, 19 Apr 2021 07:27:38 +0000 (UTC)
 (envelope-from bapt@nours.eu)
Received: from aniel.nours.eu (ns393929.ip-176-31-115.eu [176.31.115.77])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 4FNz163JZRz3Jfx;
 Mon, 19 Apr 2021 07:27:37 +0000 (UTC) (envelope-from bapt@nours.eu)
Received: by aniel.nours.eu (Postfix, from userid 1001)
 id A34723A466; Mon, 19 Apr 2021 09:27:23 +0200 (CEST)
Date: Mon, 19 Apr 2021 09:27:23 +0200
From: Baptiste Daroussin <bapt@nours.eu>
To: Ed Maste <emaste@freebsd.org>
Cc: Warner Losh <imp@bsdimp.com>, current <current@freebsd.org>
Subject: Re: sys/sys/param.h: 'main' instead of 'Master'?
Message-ID: <20210419072723.jd5jyys4go3rfwkv@aniel.nours.eu>
References: <202104161729.13GHT0g1053366@gndrsh.dnsmgr.net>
 <AD5C330C-326C-4406-8524-1DB1F04133C5@grem.de>
 <CANCZdfoMpBXVevK6nEhK+ZqjA=OUMdac0-xZbyVWaOYx+awEbQ@mail.gmail.com>
 <CAPyFy2DRZyA3b9ji71hH2S27GaFPu5Sc3GcjDsdRtm2Du1cGdg@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CAPyFy2DRZyA3b9ji71hH2S27GaFPu5Sc3GcjDsdRtm2Du1cGdg@mail.gmail.com>
X-Rspamd-Queue-Id: 4FNz163JZRz3Jfx
X-Spamd-Bar: ----
Authentication-Results: mx1.freebsd.org;
	none
X-Spamd-Result: default: False [-4.00 / 15.00];
	 REPLY(-4.00)[]
X-Mailman-Approved-At: Mon, 19 Apr 2021 08:27:14 +0000
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
 <freebsd-current.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-current>, 
 <mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current/>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
 <mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 19 Apr 2021 07:27:38 -0000

On Sun, Apr 18, 2021 at 07:07:44PM -0400, Ed Maste wrote:
> On Fri, 16 Apr 2021 at 16:22, Warner Losh <imp@bsdimp.com> wrote:
> >
> > > > As well as "Origin".
> > >
> > > (Single) Source of Truth, maybe?
> >
> > s/Master, p/P/ also makes sense.
> 
> IMO instead of lightly rewording the existing comment we could just
> remove it, it doesn't really add any clarity.
> 
> Instead we ought to add an introductory sentence or two to the block
> comment above, explaining what __FreeBSD_version actually is.

fully agreed here! I had to explained many time what __FreeBSD_version actually
was. A clear comment would be great ;)

Bapt