accumulo-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Keith Turner (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (ACCUMULO-2590) Update public API in readme to clarify what's included
Date Fri, 28 Mar 2014 20:33:17 GMT

    [ https://issues.apache.org/jira/browse/ACCUMULO-2590?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13951340#comment-13951340
] 

Keith Turner commented on ACCUMULO-2590:
----------------------------------------

bq. Do we need to make explicit that public inner classes are public API all the way down?
i.e. if an inner class has an inner class, the inner-inner class will still be public, and
so on.

That would be my expectation.  Anything public or protected in an API class is part or the
API. This would include methods, variables, classes, interfaces, and enums in the class. 
Did i miss anything?

> Update public API in readme to clarify what's included
> ------------------------------------------------------
>
>                 Key: ACCUMULO-2590
>                 URL: https://issues.apache.org/jira/browse/ACCUMULO-2590
>             Project: Accumulo
>          Issue Type: Task
>          Components: docs
>            Reporter: Sean Busbey
>            Priority: Blocker
>             Fix For: 1.6.0
>
>
> Due to confusion expressed on the mailing list, edit the README section on the public
API to make unambiguous:
> # the list of packages included (e.g. "all packages under org.apache.accumulo.core.client,
save those named 'impl'")
> # that public Classes and Interfaces in those packages are covered
> # that within said Classes and Interfaces, we include
> ## public and protected members
> ## public and protected methods
> ## public and protected constructors
> ## public and protected inner Classes and Interfaces
> And that "compatibility" means binary compatibility as defined in the [Java Language
Spec v3, Chapter 13|http://docs.oracle.com/javase/specs/jls/se5.0/html/binaryComp.html]



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message