From owner-svn-doc-all@freebsd.org  Sat Nov  7 21:00:31 2015
Return-Path: <owner-svn-doc-all@freebsd.org>
Delivered-To: svn-doc-all@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id DD415A291F0;
 Sat,  7 Nov 2015 21:00:31 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 9FFBD1A39;
 Sat,  7 Nov 2015 21:00:31 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.15.2/8.15.2) with ESMTPS id tA7L0Tbo073594
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sat, 7 Nov 2015 14:00:29 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id tA7L0SWM073591;
 Sat, 7 Nov 2015 14:00:28 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Sat, 7 Nov 2015 14:00:28 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Conrad Meyer <cem@FreeBSD.org>
cc: Benjamin Kaduk <kaduk@mit.edu>, doc-committers@freebsd.org,
 svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject: Re: svn commit: r47757 -
 head/en_US.ISO8859-1/books/porters-handbook/versions
In-Reply-To: <CAG6CVpWrAk8qO_6Uj3nWx6WzJT=dHAGmgcvP7ALsZdLa_NKqxA@mail.gmail.com>
Message-ID: <alpine.BSF.2.20.1511071345210.66783@wonkity.com>
References: <201511071838.tA7IcMGH038876@repo.freebsd.org>
 <alpine.GSO.1.10.1511071339370.26829@multics.mit.edu>
 <CAG6CVpWrAk8qO_6Uj3nWx6WzJT=dHAGmgcvP7ALsZdLa_NKqxA@mail.gmail.com>
User-Agent: Alpine 2.20 (BSF 67 2015-01-07)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sat, 07 Nov 2015 14:00:29 -0700 (MST)
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all/>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Nov 2015 21:00:32 -0000

On Sat, 7 Nov 2015, Conrad Meyer wrote:

> On Sat, Nov 7, 2015 at 10:40 AM, Benjamin Kaduk <kaduk@mit.edu> wrote:
>> It's worth keeping a placeholder entry around for 1100087 (maybe
>> "incomplete API change to sysctl_add_oid(9); see version 1100089") so that
>> people don't wonder why there's a gap.
>
> On the other hand, there are already big gaps between 1100081 and
> 1100085, and 1100086 was never documented.  Given the relatively short
> period of time (<1 day) between 1100087 and 1100089 and that this is
> on CURRENT, not a STABLE branch, I'm incline to leave it alone.  Of
> course if you're really insistent about keeping the 1100087 entry, I
> can re-add it.  (Or if you want to, go ahead. :-))

These are really a list of version numbers that are useful for checking 
specific FreeBSD features.

Since 87 was incomplete and presumably should not be used in any 
version-checking code, leaving it out is probably preferable to having 
people use it because it was the first thing they found.