db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Db-derby Wiki] Update of "ForwardCompatibility" by DavidVanCouvering
Date Tue, 28 Mar 2006 20:35:57 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.

The following page has been changed by DavidVanCouvering:
http://wiki.apache.org/db-derby/ForwardCompatibility

------------------------------------------------------------------------------
  
  Some private interfaces must have a level of stability beyond the private guarantee, even
though they are not documented.  For example, the on-disk format for Derby databases must
remain stable across minor releases and in general changes to this format should be rare,
because of the impact on upgrade.
  
+ === Deprecated ===
+    * Incompatible change allowed in minor release (x.Y)
+ 
+ An interface can be downgraded from some other classification (such as Stable) to Deprecated
to encourage users to move to a newer interface that replaces this interface.  An interface
marked as deprecated must continue to be supported until the next major release.  An interface
can be reclassified as deprecated at any minor release boundary, but requires consensus approval
within the Derby community.  The interface must be clearly documented as deprecated in the
documentation and/or release notes, and if possible warnings should be issued when an interface
is used that it is deprecated (with the ability to turn these warnings off).
+ 
  == Interface Table ==
  
  This table describes each of the interfaces Derby provides, and the stability guarantee
we provide for that interface.

Mime
View raw message