From commits-return-3308-apmail-sis-commits-archive=sis.apache.org@sis.apache.org Mon Dec 23 01:57:50 2013 Return-Path: X-Original-To: apmail-sis-commits-archive@www.apache.org Delivered-To: apmail-sis-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id D31541042C for ; Mon, 23 Dec 2013 01:57:50 +0000 (UTC) Received: (qmail 42483 invoked by uid 500); 23 Dec 2013 01:57:50 -0000 Delivered-To: apmail-sis-commits-archive@sis.apache.org Received: (qmail 42462 invoked by uid 500); 23 Dec 2013 01:57:50 -0000 Mailing-List: contact commits-help@sis.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: sis-dev@sis.apache.org Delivered-To: mailing list commits@sis.apache.org Received: (qmail 42455 invoked by uid 500); 23 Dec 2013 01:57:50 -0000 Delivered-To: apmail-incubator-sis-commits@incubator.apache.org Received: (qmail 42452 invoked by uid 99); 23 Dec 2013 01:57:50 -0000 Received: from arcas.apache.org (HELO arcas.apache.org) (140.211.11.28) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 23 Dec 2013 01:57:50 +0000 Date: Mon, 23 Dec 2013 01:57:50 +0000 (UTC) From: "Martin Desruisseaux (JIRA)" To: sis-commits@incubator.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Commented] (SIS-88) Reduce side of public API MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/SIS-88?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13855335#comment-13855335 ] Martin Desruisseaux commented on SIS-88: ---------------------------------------- Removed {{@Decorator}} for SIS 0.4, which was almost unused in public API. > Reduce side of public API > ------------------------- > > Key: SIS-88 > URL: https://issues.apache.org/jira/browse/SIS-88 > Project: Spatial Information Systems > Issue Type: Improvement > Components: Utilities > Affects Versions: 0.3, 0.4 > Reporter: Martin Desruisseaux > Priority: Minor > Fix For: 0.3, 0.4 > > > Consider moving the following elements to an internal package: > * {{@Debug}} > * {{@Workaround}} > * {{@Immutable}} (like JCIP, but with {{Retention.SOURCE}}) > * {{@ThreadSafe}} (like JCIP, but with {{Retention.SOURCE}}) > * {{@NotThreadSafe}} (like JCIP, but with {{Retention.SOURCE}}) > * {{CheckedArrayList}} > * {{CheckedHashSet}} > * More may be added later. > Actually the above elements may have some value for the users, but maybe not enough for deserving to appear in documentation (admittedly thread-safety information are important, but the annotation may not be a so good replacement to explanation in Javadoc text). -- This message was sent by Atlassian JIRA (v6.1.5#6160)