From nobody Fri Dec 19 02:56:47 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dXXJ40jQbz6KjR2 for ; Fri, 19 Dec 2025 02:57:08 +0000 (UTC) (envelope-from rick.macklem@gmail.com) Received: from mail-ej1-x62d.google.com (mail-ej1-x62d.google.com [IPv6:2a00:1450:4864:20::62d]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "WR4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dXXJ33PMbz3RR1 for ; Fri, 19 Dec 2025 02:57:07 +0000 (UTC) (envelope-from rick.macklem@gmail.com) Authentication-Results: mx1.freebsd.org; none Received: by mail-ej1-x62d.google.com with SMTP id a640c23a62f3a-b735e278fa1so238101166b.0 for ; Thu, 18 Dec 2025 18:57:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766113021; x=1766717821; darn=freebsd.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=AIM5ntAew378F3LH8ydEfVdgp5RhCTqyG1HsqK5NF08=; b=HcJeh6PrxHuuuAY9PaeXKYYkMaK0kBv0pAaSyZZwfoE4hulE2VmQghHZXkEwL34nBS oMPwkvj6Dx41aNl/9gmvHZYJeOmqx5b1IqmMIDRyUfim35OxlY84xlyjGiESELnT+H4B nEq9o2kxH6Pe71bA226Mu+ggT638ZNfOHDn8X2wnUFELSkRhiHpDLXL9omCkN6COpVQo xG6s9fcmUFttEPvLrl9JNqbbIcYiysgLw78qaPUJb2zZDqc8W72YePGC2MBA64tXdT87 Vvvf1Gb86yU69gJvuzr3bSki9M0agWUERWlcM0L/+kYH6jZcdo2YaCNFNDcBcVIwwJsV D0Ng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766113021; x=1766717821; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=AIM5ntAew378F3LH8ydEfVdgp5RhCTqyG1HsqK5NF08=; b=vZoSa0XuvUwB1bIukBaDYTOKMwR0JRrJd2LmUYrHXMH+D/ESZcQZt8Cy6Izak8M8go DKrLQCwwWFiGKl6GpxVnCokFrFy8H3dPR67mfUilRsUeYNtL5iVHCCbvWlC88Vhamuse 9FXYV46SQrLkkfdn9lxN2rasgfU9Keh3TjC5P/H/Na9+gfYJpboO9dPQ3omyPQ1uaTYF SJgedidv/DkJW5jenajGJmZ9Qpi03rXBzCyQk/Kqr6iFsbGszIkEqw6fPzwliEnAmJ2X VaAu6wp/o7unwzg4t8sQ3RWnLjH7jiUnJZMMrvcnpB95E3FdhgR4zSMUzmKEkcjogIMg e6fA== X-Forwarded-Encrypted: i=1; AJvYcCXijQ227GB7YkRJe8749pFtaklT1wgbXC/dmJD2uqxxn+g1FW63R1K0p0Vb7wmo46tOhvhIo6xlwFFoe/t9WZNYs2Vw@freebsd.org X-Gm-Message-State: AOJu0Yzy81X7iv2q31sDRCCtKvfvyN8A1r7x6nwCavMrbnImLulWLq+s 9OO53BUCz8UwzqRVWLMMeqXQ3l9d3g222MYkmuabQwNSkm/FrJMRY2Mz552PqTC918m7thWXi0L PZchbqVxdFY2ASsfWMlQ7NYTDpuFujg== X-Gm-Gg: AY/fxX7excHORmNPIV1Nfc02+58HHg3kBK+WMkO3mbUeMdcAjMQAJUUSCJ+tUl0de9c 6py0+1W4fL6v1wnSP0MMHDDtKQbrZm+c0Hty/MqbDfgw7QcUwOH2lDg5MWNiBzUBAxCxtfB+cd0 fWeAuh9eam8e2jjakI84Xq+hhtwTBLxiCHHc6Ou7CzjXfwbiAn5YmJqNkfZVElRTK0Diq0Vcjjk gVjH9g977hh50Mz9Ww/o3zQWvieTttMAQZAjcXPFYDQ7XOFAFWh59tUc1/3v9KJBjyiCcYLI5km SiijK4mai4zl56wT8CA6Fo8Hpfe+Gm3vy5s= X-Google-Smtp-Source: AGHT+IFTRqc6QxkXNm5T3JAoCZ/2h+6zL+AfZAckXVaowfzNCZoZiKpHW42FVcdbPzA/IBL8aSN5rdnlQLMYI5m1lKE= X-Received: by 2002:a17:907:7e91:b0:b7c:fe7c:e36e with SMTP id a640c23a62f3a-b8036ec639cmr136712066b.11.1766113020947; Thu, 18 Dec 2025 18:57:00 -0800 (PST) List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 References: <69447e71.46420.2787bc4a@gitrepo.freebsd.org> <987ad115-9c14-4f5e-8e1d-ef69f84afd9e@FreeBSD.org> In-Reply-To: <987ad115-9c14-4f5e-8e1d-ef69f84afd9e@FreeBSD.org> From: Rick Macklem Date: Thu, 18 Dec 2025 18:56:47 -0800 X-Gm-Features: AQt7F2oNQWz-l13j5g4rK5gll2TWWQp7Cf8OUEGK1D-EaKWZAF_H7sZ9_QwFJK0 Message-ID: Subject: Re: git: 481fce462d - main - Document various missing __FreeBSD_version values. To: John Baldwin Cc: src-committers , dev-commits-doc-all@freebsd.org, doc-committers@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Rspamd-Queue-Id: 4dXXJ33PMbz3RR1 On Thu, Dec 18, 2025 at 5:45=E2=80=AFPM John Baldwin wrot= e: > > On 12/18/25 17:53, Rick Macklem wrote: > > I'm guilty. But someone said that it should only be bumped > > if no one else has bumped it recently. (Within a few days?) > > > > If it isn't getting bumped for every change, the document > > is basically useless, isn't it? > > The main reason it is documented in the porter's handbook is so that if p= orts > need to use conditional logic, this is a reference to which versions to u= se. > > Ports doesn't need perfect granularity (especially on main), just somethi= ng > that is "close", hence why bumping more often than, say, once a day is > probably overkill. Well, for my case it is inevitably "the internal KAPI between the NFS modules have changed and all of hem need to be rebuilt from sources". (Since this cannot affect any port, does it make sense to document it?) I do put entries in UPDATING. rick > > -- > John Baldwin >