You are viewing a plain text version of this content. The canonical link for it is here.
Posted to solr-dev@lucene.apache.org by "Mattmann, Chris A (388J)" <ch...@jpl.nasa.gov> on 2009/12/30 17:43:00 UTC
Re: svn commit: r894477 -
/lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUtils.java
Hi Yonik,
What does this tag mean/do?
Cheers,
Chris
On 12/29/09 12:30 PM, "yonik@apache.org" <yo...@apache.org> wrote:
> Author: yonik
> Date: Tue Dec 29 20:30:53 2009
> New Revision: 894477
>
> URL: http://svn.apache.org/viewvc?rev=894477&view=rev
> Log:
> SOLR-1586: add solr-internal tag
>
> Modified:
>
> lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUt
> ils.java
>
> Modified:
> lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUt
> ils.java
> URL:
> http://svn.apache.org/viewvc/lucene/solr/trunk/src/java/org/apache/solr/search
> /function/distance/DistanceUtils.java?rev=894477&r1=894476&r2=894477&view=diff
> ==============================================================================
> ---
> lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUt
> ils.java (original)
> +++
> lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUt
> ils.java Tue Dec 29 20:30:53 2009
> @@ -20,7 +20,8 @@
>
>
> /**
> - * Useful distance utiltities
> + * Useful distance utiltities.
> + * solr-internal: subject to change w/o notification.
> *
> **/
> public class DistanceUtils {
>
>
>
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Senior Computer Scientist
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 171-266B, Mailstop: 171-246
Email: Chris.Mattmann@jpl.nasa.gov
WWW: http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Assistant Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Re: svn commit: r894477 -
/lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUtils.java
Posted by Chris Hostetter <ho...@fucit.org>.
: > What does this tag mean/do?
:
: It notifies anyone looking at it that it's "subject to change w/o notification."
Why not make it an actual javadoc tag? (ie "@solr.internal") so it stands
out more?
-Hoss
Re: svn commit: r894477 -
/lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUtils.java
Posted by "Mattmann, Chris A (388J)" <ch...@jpl.nasa.gov>.
Thanks, got it!
Cheers,
Chris
On 12/30/09 8:53 AM, "Yonik Seeley" <yo...@lucidimagination.com> wrote:
> On Wed, Dec 30, 2009 at 11:43 AM, Mattmann, Chris A (388J)
> <ch...@jpl.nasa.gov> wrote:
>> Hi Yonik,
>>
>> What does this tag mean/do?
>
> It notifies anyone looking at it that it's "subject to change w/o
> notification."
> We're primarily implementing higher-level features, not creating new
> low-level APIs, and I just wanted to make it clear that stuff like
> "DistanceUtils" is more implementation than interface and can change
> to meet the needs of the primary higher level APIs w/o the burden of
> back compat.
>
> -Yonik
> http://www.lucidimagination.com
>
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Senior Computer Scientist
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 171-266B, Mailstop: 171-246
Email: Chris.Mattmann@jpl.nasa.gov
WWW: http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Assistant Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Re: svn commit: r894477 - /lucene/solr/trunk/src/java/org/apache/solr/search/function/distance/DistanceUtils.java
Posted by Yonik Seeley <yo...@lucidimagination.com>.
On Wed, Dec 30, 2009 at 11:43 AM, Mattmann, Chris A (388J)
<ch...@jpl.nasa.gov> wrote:
> Hi Yonik,
>
> What does this tag mean/do?
It notifies anyone looking at it that it's "subject to change w/o notification."
We're primarily implementing higher-level features, not creating new
low-level APIs, and I just wanted to make it clear that stuff like
"DistanceUtils" is more implementation than interface and can change
to meet the needs of the primary higher level APIs w/o the burden of
back compat.
-Yonik
http://www.lucidimagination.com