Return-Path: Delivered-To: apmail-lucene-java-commits-archive@www.apache.org Received: (qmail 2410 invoked from network); 3 Sep 2009 14:03:56 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 3 Sep 2009 14:03:56 -0000 Received: (qmail 95712 invoked by uid 500); 3 Sep 2009 14:03:56 -0000 Delivered-To: apmail-lucene-java-commits-archive@lucene.apache.org Received: (qmail 95650 invoked by uid 500); 3 Sep 2009 14:03:56 -0000 Mailing-List: contact java-commits-help@lucene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: java-dev@lucene.apache.org Delivered-To: mailing list java-commits@lucene.apache.org Received: (qmail 95641 invoked by uid 99); 3 Sep 2009 14:03:56 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 03 Sep 2009 14:03:56 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 03 Sep 2009 14:03:44 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 32E4C2388852; Thu, 3 Sep 2009 14:03:23 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r810951 - in /lucene/java/trunk/contrib/spatial/src/java: ./ org/apache/lucene/spatial/geohash/ org/apache/lucene/spatial/geometry/ org/apache/lucene/spatial/geometry/shape/ org/apache/lucene/spatial/tier/ org/apache/lucene/spatial/tier/pro... Date: Thu, 03 Sep 2009 14:03:22 -0000 To: java-commits@lucene.apache.org From: mikemccand@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20090903140323.32E4C2388852@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mikemccand Date: Thu Sep 3 14:03:19 2009 New Revision: 810951 URL: http://svn.apache.org/viewvc?rev=810951&view=rev Log: LUCENE-1878: make it clear that contrib/spatial is still experimental Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java lucene/java/trunk/contrib/spatial/src/java/overview.html Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java Thu Sep 3 14:03:19 2009 @@ -28,6 +28,10 @@ import org.apache.lucene.spatial.tier.DistanceUtils; +/**

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class GeoHashDistanceFilter extends DistanceFilter { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java Thu Sep 3 14:03:19 2009 @@ -22,6 +22,10 @@ /** * Based on http://en.wikipedia.org/wiki/Geohash + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class GeoHashUtils { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java Thu Sep 3 14:03:19 2009 @@ -21,6 +21,10 @@ * Represents lat/lngs as fixed point numbers translated so that all * world coordinates are in the first quadrant. The same fixed point * scale as is used for FixedLatLng is employed. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianPoint { private int x; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public enum DistanceUnits { MILES, KILOMETERS; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class FixedLatLng extends LatLng { public static final double SCALE_FACTOR=1000000; public static final int SCALE_FACTOR_INT=1000000; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class FloatLatLng extends LatLng { private double lat; private double lng; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java Thu Sep 3 14:03:19 2009 @@ -23,7 +23,10 @@ * point based coordinates. Instances are immutable. * * @see FloatLatLng - * + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public abstract class LatLng { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java Thu Sep 3 14:03:19 2009 @@ -19,6 +19,10 @@ /** * Imported from mq java client. No changes made. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class DistanceApproximation { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * Ellipse shape. From C++ gl. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Ellipse implements Geometry2D { private Point2D center; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * Common set of operations available on 2d shapes. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public interface Geometry2D { /** Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,12 @@ package org.apache.lucene.spatial.geometry.shape; +/** + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public enum IntersectCase { WITHIN, CONTAINS, Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java Thu Sep 3 14:03:19 2009 @@ -24,6 +24,10 @@ /** * Lat-long rect. Instances are mutable. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class LLRect { private LatLng ll, ur; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * 2d line segment. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class LineSegment { public final Point2D A = new Point2D(); Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * Point class. This type is mutable. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Point2D { private double x; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * Rectangle shape. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Rectangle implements Geometry2D { private Point2D ptMin, ptMax; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java Thu Sep 3 14:03:19 2009 @@ -20,6 +20,10 @@ /** * 2D vector + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Vector2D { private double x; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java Thu Sep 3 14:03:19 2009 @@ -29,7 +29,9 @@ /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianPolyFilterBuilder { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java Thu Sep 3 14:03:19 2009 @@ -28,6 +28,11 @@ import org.apache.lucene.util.NumericUtils; import org.apache.lucene.util.OpenBitSet; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class CartesianShapeFilter extends Filter { /** Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java Thu Sep 3 14:03:19 2009 @@ -24,6 +24,11 @@ import org.apache.lucene.search.FieldComparator; import org.apache.lucene.search.FieldComparatorSource; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceFieldComparatorSource extends FieldComparatorSource { private static final long serialVersionUID = 1L; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java Thu Sep 3 14:03:19 2009 @@ -23,6 +23,11 @@ import org.apache.lucene.search.Filter; import org.apache.lucene.spatial.tier.DistanceHandler.Precision; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public abstract class DistanceFilter extends Filter { final protected Filter startingFilter; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java Thu Sep 3 14:03:19 2009 @@ -24,6 +24,9 @@ * Provide a high level access point to distances * Used by DistanceSortSource and DistanceQuery * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. * */ public class DistanceHandler { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java Thu Sep 3 14:03:19 2009 @@ -24,7 +24,11 @@ import org.apache.lucene.spatial.geohash.GeoHashDistanceFilter; import org.apache.lucene.misc.ChainedFilter; - +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceQueryBuilder { private static final long serialVersionUID = 1L; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java Thu Sep 3 14:03:19 2009 @@ -23,7 +23,11 @@ import org.apache.lucene.spatial.geometry.shape.LLRect; import org.apache.lucene.spatial.geometry.shape.Rectangle; - +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceUtils { static DistanceUtils instance = new DistanceUtils(); Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.tier; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class InvalidGeoException extends Exception { /** Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java Thu Sep 3 14:03:19 2009 @@ -25,6 +25,11 @@ import org.apache.lucene.search.DocIdSet; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class LatLongDistanceFilter extends DistanceFilter { /** Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java Thu Sep 3 14:03:19 2009 @@ -21,7 +21,9 @@ import java.util.List; /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Shape { Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java Thu Sep 3 14:03:19 2009 @@ -18,7 +18,9 @@ package org.apache.lucene.spatial.tier.projections; /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianTierPlotter { public static final String DEFALT_FIELD_PREFIX = "_tier_"; Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java Thu Sep 3 14:03:19 2009 @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.tier.projections; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public interface IProjector { public String coordsAsString(double latitude, double longitude); public double[] coords(double latitude, double longitude); Modified: lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java (original) +++ lucene/java/trunk/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java Thu Sep 3 14:03:19 2009 @@ -20,7 +20,10 @@ /** * Based on Sinusoidal Projections * Project a latitude / longitude on a 2D cartisian map - * + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class SinusoidalProjector implements IProjector { Modified: lucene/java/trunk/contrib/spatial/src/java/overview.html URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/spatial/src/java/overview.html?rev=810951&r1=810950&r2=810951&view=diff ============================================================================== --- lucene/java/trunk/contrib/spatial/src/java/overview.html (original) +++ lucene/java/trunk/contrib/spatial/src/java/overview.html Thu Sep 3 14:03:19 2009 @@ -17,10 +17,31 @@ - spatial + Geographical filtering & sorting with Lucene - spatial + +

This package makes it possible to filter and sort according to +geographical constraints. For example, filter to include only +restaurants within 2 miles of a specified latitude/longitude, sorting +by distance ascending.

+ +

See here +for details on the technical approach.

+ +

Unfortunately, this package is still very new, and has little to no +documentation. It's best to ask for pointers on +java-user@lucene.apache.org, and look at the unit tests included in +the source distribution.

+ +

There are also known issues, eg at +least LUCENE-1781 +and LUCENE-1815.

+ +

NOTE: This package is still in flux and +might change in incompatible ways in the next release. + - \ No newline at end of file + +