From derby-commits-return-1506-apmail-db-derby-commits-archive=db.apache.org@db.apache.org Wed Oct 12 16:01:16 2005 Return-Path: Delivered-To: apmail-db-derby-commits-archive@www.apache.org Received: (qmail 39845 invoked from network); 12 Oct 2005 16:01:12 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 12 Oct 2005 16:01:12 -0000 Received: (qmail 2283 invoked by uid 500); 12 Oct 2005 16:00:56 -0000 Delivered-To: apmail-db-derby-commits-archive@db.apache.org Received: (qmail 2249 invoked by uid 500); 12 Oct 2005 16:00:56 -0000 Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Derby Development" List-Id: Delivered-To: mailing list derby-commits@db.apache.org Received: (qmail 2227 invoked by uid 99); 12 Oct 2005 16:00:56 -0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received: from [192.87.106.226] (HELO ajax.apache.org) (192.87.106.226) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 12 Oct 2005 09:00:54 -0700 Received: from ajax.apache.org (ajax.apache.org [127.0.0.1]) by ajax.apache.org (Postfix) with ESMTP id 0F6FC512 for ; Wed, 12 Oct 2005 18:00:33 +0200 (CEST) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Apache Wiki To: derby-commits@db.apache.org Date: Wed, 12 Oct 2005 16:00:33 -0000 Message-ID: <20051012160033.7777.62673@ajax.apache.org> Subject: [Db-derby Wiki] Update of "SharedComponentVersioningGuidelines" by DavidVanCouvering X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N 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/SharedComponentVersioningGuidelines ------------------------------------------------------------------------------ The guidelines for shared components in Derby are based on the [http://jakarta.apache.org/commons/releases/versioning.html Jakarta Runtime Versioning Guidelines]. There are some areas that these guidelines do not cover, however, which we will address here: + [[TableOfContents]] - * Mixed Version support - - * Version publishing and detection - - * Guidelines for forward-compatibility - - * Deprecation guidelines and mechanisms - - * Packaging of common components == Mixed Version Support == @@ -81, +73 @@ '''NOTE:''' I still need to investigate to see if you can have a method call to a non-existent method in your code as long as the code is never executed. - === Deprecation Guidelines === + == Deprecation Guidelines == A method or an interface may be deprecated. This is done using the @deprecated tag in the method or interface Javadoc. A method or interface must be available for 2 major releases after it is deprecated. For example, if it is deprecated in version 8.2, it can be removed in version 10.0 or greater. An exception to this rule may occur if it becomes clear that there is still heavy use of this interface. - === Distribution of Shared Components === + == Distribution of Shared Components == To help make explicit the various shared components within Derby and what is contained in them, our internal build will create a seprate JAR file for each shared component.