Mailing-List: contact cygwin-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin/>
List-Post: <mailto:cygwin AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin AT sources DOT redhat DOT com
Date: Sat, 20 Oct 2001 16:18:16 +0100
Message-ID: <8408-Sat20Oct2001161817+0100-starksb@ebi.ac.uk>
X-Mailer: 21.5  (beta2) "artichoke" XEmacs Lucid (via feedmail 9-beta-7 I);
	VM 6.92 under 21.5  (beta2) "artichoke" XEmacs Lucid
From: David Starks-Browning <starksb AT ebi DOT ac DOT uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
To: cygwin AT cygwin DOT com
Subject: Re: Is cygwin1.dll backward compatible?
In-Reply-To: <1253828865.20011020185645@logos-m.ru>
References: <15313 DOT 35640 DOT 955278 DOT 459904 AT coyote DOT priv DOT helixdigital DOT com>
	<1253828865 DOT 20011020185645 AT logos-m DOT ru>

On Saturday 20 Oct 01, egor duda writes:
> ... if/when cygwin team is about to make backward-incompatible
> changes to cygwin, dll is supposed to be renamed to cygwin2.dll
> 
> you can look at "api major" and "api minor" lines in output from
> 'cygcheck -v -s'. "api minor" is incremented whenever anybody makes
> forward-incompatible changes to dll (such as exporting new function or
> data from dll). "api major" is incremented whenever backward-
> incompatible change is made.

There is an entry in the API section of the FAQ, but it has not been
updated since B19:

Q.  What version numbers are associated with Cygwin?

A.  There is a cygwin.dll major version number that gets incremented
    every time we make a new Cygwin release available. This
    corresponds to the name of the release (e.g. beta 19's major
    number is "19"). There is also a cygwin.dll minor version
    number. If we release an update of the library for an existing
    release, the minor number would be incremented.
    
    There are also Cygwin API major and minor numbers. The major
    number tracks important non-backward-compatible interface changes
    to the API. An executable linked with an earlier major number will
    not be compatible with the latest DLL. The minor number tracks
    significant API additions or changes that will not break older
    executables but may be required by newly compiled ones.
    
    Then there is a shared memory region compatibity version
    number. It is incremented when incompatible changes are made to
    the shared memory region or to any named shared mutexes,
    semaphores, etc.
    
    Finally there is a mount point registry version number which keeps
    track of non-backwards-compatible changes to the registry mount
    table layout. This has been "B15.0" since the beta 15 release.

It would be great if someone could provide the text that brings it up
to date.  Maybe I just have to remove references to "beta 19"?  What
about the mount table?  I guess now it's "mount v2"?

Thanks,
David


--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Bug reporting:         http://cygwin.com/bugs.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/