accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ktur...@apache.org
Subject svn commit: r1680083 - /accumulo/site/trunk/content/release_notes/1.7.0.mdtext
Date Mon, 18 May 2015 20:03:49 GMT
Author: kturner
Date: Mon May 18 20:03:48 2015
New Revision: 1680083

URL: http://svn.apache.org/r1680083
Log:
ACCUMULO-3737 Fix paragraphs

Modified:
    accumulo/site/trunk/content/release_notes/1.7.0.mdtext

Modified: accumulo/site/trunk/content/release_notes/1.7.0.mdtext
URL: http://svn.apache.org/viewvc/accumulo/site/trunk/content/release_notes/1.7.0.mdtext?rev=1680083&r1=1680082&r2=1680083&view=diff
==============================================================================
--- accumulo/site/trunk/content/release_notes/1.7.0.mdtext (original)
+++ accumulo/site/trunk/content/release_notes/1.7.0.mdtext Mon May 18 20:03:48 2015
@@ -114,16 +114,9 @@ options and file creation options.
 
 ### API Clarification
 
-The declared API in 1.6.x was incomplete.   Some important classes like ColumnVisibility
were not declared as Accumulo API.  
-A lot of work was done under [ACCUMULO-3657][ACCUMULO-3657] to correct the API statement
and clean up the API.  The expanded 
-and simplified API statement is in the [README][readme].
+The declared API in 1.6.x was incomplete.   Some important classes like ColumnVisibility
were not declared as Accumulo API.  A lot of work was done under [ACCUMULO-3657][ACCUMULO-3657]
to correct the API statement and clean up the API.  The expanded  and simplified API statement
is in the [README][readme].
 
-In some places in the API, non API types were used.  Ideally public API members would only
use public API types.  A tool called 
-[APILyzer][apilyzer] was created to find all API members that used non-API types.  Many of
the violations found by this tool were deprecated to clearly communicate that a non API type
was used.  
-For example, a few public API methods returned a class called KeyExtent.  KeyExtent was never
intended to be in the public API, 
-it contains a lot of code related to Accumulo internals.   KeyExtent and the API methods
returning it were deprecated.  These 
-were replaced with a new way of identifying tablets that does not expose internals.  Deprecating
a type like this from the API 
-makes the API more stable and makes it easier for contributors to change Accumulo internals
w/o impacting the API.
+In some places in the API, non API types were used.  Ideally public API members would only
use public API types.  A tool called [APILyzer][apilyzer] was created to find all API members
that used non-API types.  Many of the violations found by this tool were deprecated to clearly
communicate that a non API type was used.  For example, a few public API methods returned
a class called KeyExtent.  KeyExtent was never intended to be in the public API, it contains
a lot of code related to Accumulo internals.   KeyExtent and the API methods returning it
were deprecated.  These were replaced with a new way of identifying tablets that does not
expose internals.  Deprecating a type like this from the API makes the API more stable and
makes it easier for contributors to change Accumulo internals w/o impacting the API.
 
 Created an Accumulo API regular expression for use with checkstyle.  Starting with 1.7.0,
projects building on Accumulo can use this checkstyle rule to ensure they are only using Accumulo's
public API.  The regular expression can be found in the [README][readme].
 



Mime
View raw message