From owner-cvs-gnu  Tue May  9 19:04:05 1995
Return-Path: cvs-gnu-owner
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id TAA03986
          for cvs-gnu-outgoing; Tue, 9 May 1995 19:04:05 -0700
Received: from gndrsh.aac.dev.com (gndrsh.aac.dev.com [198.145.92.241])
          by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id TAA03975
          ; Tue, 9 May 1995 19:03:45 -0700
Received: (from rgrimes@localhost) by gndrsh.aac.dev.com (8.6.11/8.6.9) id TAA06456; Tue, 9 May 1995 19:02:26 -0700
From: "Rodney W. Grimes" <rgrimes@gndrsh.aac.dev.com>
Message-Id: <199505100202.TAA06456@gndrsh.aac.dev.com>
Subject: Re: cvs commit: src/gnu/lib/libreadline Makefile
To: asami@cs.berkeley.edu (Satoshi Asami | =?ISO-2022-JP?B?GyRCQHUbKEI=?= =?ISO-2022-JP?B?GyRCOCsbKEIgGyRCOC0bKEI=?=)
Date: Tue, 9 May 1995 19:02:26 -0700 (PDT)
Cc: wollman@halloran-eldar.lcs.mit.edu, paul@isl.cf.ac.uk, bde@zeta.org.au,
        ache@freefall.cdrom.com, CVS-commiters@freefall.cdrom.com,
        cvs-gnu@freefall.cdrom.com
In-Reply-To: <199505100135.SAA16944@forgery.CS.Berkeley.EDU> from "Satoshi Asami | =?ISO-2022-JP?B?GyRCQHUbKEI=?= =?ISO-2022-JP?B?GyRCOCsbKEIgGyRCOC0bKEI=?=" at May 9, 95 06:35:54 pm
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Length: 1625      
Sender: cvs-gnu-owner@freebsd.org
Precedence: bulk

> 
>  * > I thought we agreed that it would get bunped *once* per release.
>  * 
>  * Indeed we did so agree.
>  * 
>  * (Well, closer to the mark, I recommended establishing such a policy, a
>  * few people stated their agreement, and nobody objected at the time.)
> 
> Ok...then let me reiterate the proposal.
> 
> ========<from here>========
> 
> The version number gets bumped the first time someone changes
> something in a library (in a visible way from the caller) after a
> release.  It stays there until the next release (except, of course
> when the first change requires a minor number change and the second
> requires a major number change), so people modifying the library
> should check the commit logs before changing the version numbers.
> 
> Note:
> 
> The following events cause major version numbers to be bumped
> 
> (1) deleting a function
> (2) interface change (different argument order, etc.)
(3) change of functionality in a function (ie, when I add %b to
printf it will require a major number bump, since calling the
old printf with a %b will just blow it out of the water).

> and the following events will require the minor number to be bumped
> 
> (3) adding a function
> 
> In general, a x.y library can be substituted for x.z if y > z, and
> this is the only possible substitution.
> 
> =========<to here>=========
> 
> If nobody objects, then this will become the official policy. :)

Please commit it as /usr/src/policy/library_versions

-- 
Rod Grimes                                      rgrimes@gndrsh.aac.dev.com
Accurate Automation Company                   Custom computers for FreeBSD