You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-commits@lucene.apache.org by rm...@apache.org on 2010/01/31 16:20:28 UTC
svn commit: r905057 [1/2] - in /lucene/java/trunk: ./
contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/
contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/
contrib/ant/src/java/org/apache/lucene/ant/ contr...
Author: rmuir
Date: Sun Jan 31 15:20:26 2010
New Revision: 905057
URL: http://svn.apache.org/viewvc?rev=905057&view=rev
Log:
LUCENE-2209: add @lucene.internal/@lucene.experimental javadoc tags
Modified:
lucene/java/trunk/common-build.xml
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/AnalyzerProfile.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/CharType.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SentenceTokenizer.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SmartChineseAnalyzer.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/Utility.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordSegmenter.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordTokenFilter.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordType.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/AbstractDictionary.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BiSegGraph.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BigramDictionary.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/HHMMSegmenter.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/PathNode.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegGraph.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegToken.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenFilter.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenPair.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/WordDictionary.java
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/package.html
lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html
lucene/java/trunk/contrib/ant/src/java/org/apache/lucene/ant/TextDocument.java
lucene/java/trunk/contrib/benchmark/src/java/org/apache/lucene/benchmark/byTask/tasks/NearRealtimeReaderTask.java
lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/InstantiatedIndex.java
lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/package.html
lucene/java/trunk/contrib/misc/src/java/org/apache/lucene/index/IndexSplitter.java
lucene/java/trunk/contrib/wikipedia/src/java/org/apache/lucene/wikipedia/analysis/WikipediaTokenizer.java
lucene/java/trunk/src/java/org/apache/lucene/analysis/NumericTokenStream.java
lucene/java/trunk/src/java/org/apache/lucene/analysis/Token.java
lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.java
lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttributeImpl.java
lucene/java/trunk/src/java/org/apache/lucene/document/NumericField.java
lucene/java/trunk/src/java/org/apache/lucene/index/CheckIndex.java
lucene/java/trunk/src/java/org/apache/lucene/index/DirectoryReader.java
lucene/java/trunk/src/java/org/apache/lucene/index/FieldInvertState.java
lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsDocsConsumer.java
lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsFieldsConsumer.java
lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsTermsConsumer.java
lucene/java/trunk/src/java/org/apache/lucene/index/IndexCommit.java
lucene/java/trunk/src/java/org/apache/lucene/index/IndexReader.java
lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java
lucene/java/trunk/src/java/org/apache/lucene/index/MergePolicy.java
lucene/java/trunk/src/java/org/apache/lucene/index/MergeScheduler.java
lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfo.java
lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfos.java
lucene/java/trunk/src/java/org/apache/lucene/index/SegmentReader.java
lucene/java/trunk/src/java/org/apache/lucene/index/SnapshotDeletionPolicy.java
lucene/java/trunk/src/java/org/apache/lucene/search/Collector.java
lucene/java/trunk/src/java/org/apache/lucene/search/DefaultSimilarity.java
lucene/java/trunk/src/java/org/apache/lucene/search/FieldCache.java
lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparator.java
lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparatorSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/FieldValueHitQueue.java
lucene/java/trunk/src/java/org/apache/lucene/search/IndexSearcher.java
lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeFilter.java
lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeQuery.java
lucene/java/trunk/src/java/org/apache/lucene/search/Similarity.java
lucene/java/trunk/src/java/org/apache/lucene/search/SortField.java
lucene/java/trunk/src/java/org/apache/lucene/search/SpanFilterResult.java
lucene/java/trunk/src/java/org/apache/lucene/search/TopFieldCollector.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/ByteFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/CustomScoreQuery.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/DocValues.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldCacheSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldScoreQuery.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/FloatFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/IntFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/OrdFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/ReverseOrdFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/ShortFieldSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSource.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSourceQuery.java
lucene/java/trunk/src/java/org/apache/lucene/search/function/package.html
lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadFunction.java
lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadSpanUtil.java
lucene/java/trunk/src/java/org/apache/lucene/search/spans/Spans.java
lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexInput.java
lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexOutput.java
lucene/java/trunk/src/java/org/apache/lucene/store/FileSwitchDirectory.java
lucene/java/trunk/src/java/org/apache/lucene/util/ArrayUtil.java
lucene/java/trunk/src/java/org/apache/lucene/util/BitUtil.java
lucene/java/trunk/src/java/org/apache/lucene/util/CharacterUtils.java
lucene/java/trunk/src/java/org/apache/lucene/util/CloseableThreadLocal.java
lucene/java/trunk/src/java/org/apache/lucene/util/DummyConcurrentLock.java
lucene/java/trunk/src/java/org/apache/lucene/util/English.java
lucene/java/trunk/src/java/org/apache/lucene/util/FieldCacheSanityChecker.java
lucene/java/trunk/src/java/org/apache/lucene/util/IndexableBinaryStringTools.java
lucene/java/trunk/src/java/org/apache/lucene/util/MapOfSets.java
lucene/java/trunk/src/java/org/apache/lucene/util/NumericUtils.java
lucene/java/trunk/src/java/org/apache/lucene/util/Parameter.java
lucene/java/trunk/src/java/org/apache/lucene/util/PriorityQueue.java
lucene/java/trunk/src/java/org/apache/lucene/util/RamUsageEstimator.java
lucene/java/trunk/src/java/org/apache/lucene/util/ReaderUtil.java
lucene/java/trunk/src/java/org/apache/lucene/util/ScorerDocQueue.java
lucene/java/trunk/src/java/org/apache/lucene/util/SimpleStringInterner.java
lucene/java/trunk/src/java/org/apache/lucene/util/SmallFloat.java
lucene/java/trunk/src/java/org/apache/lucene/util/StringHelper.java
lucene/java/trunk/src/java/org/apache/lucene/util/UnicodeUtil.java
lucene/java/trunk/src/java/org/apache/lucene/util/VirtualMethod.java
lucene/java/trunk/src/java/org/apache/lucene/util/cache/Cache.java
lucene/java/trunk/src/java/org/apache/lucene/util/cache/DoubleBarrelLRUCache.java
lucene/java/trunk/src/java/org/apache/lucene/util/cache/SimpleLRUCache.java
lucene/java/trunk/src/java/org/apache/lucene/util/cache/SimpleMapCache.java
Modified: lucene/java/trunk/common-build.xml
URL: http://svn.apache.org/viewvc/lucene/java/trunk/common-build.xml?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/common-build.xml (original)
+++ lucene/java/trunk/common-build.xml Sun Jan 31 15:20:26 2010
@@ -633,8 +633,10 @@
doctitle="@{title}"
maxmemory="${javadoc.maxmemory}"
bottom="Copyright © ${year} Apache Software Foundation. All Rights Reserved.">
- <tag name="todo" description="To Do:"/>
- <tag name="uml.property" description="UML Property:"/>
+ <tag name="lucene.experimental"
+ description="WARNING: This API is experimental and might change in incompatible ways in the next release."/>
+ <tag name="lucene.internal"
+ description="NOTE: This API is for Lucene internal purposes only and might change in incompatible ways in the next release."/>
<link offline="true" packagelistLoc="${javadoc.dir}"/>
<sources />
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/AnalyzerProfile.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/AnalyzerProfile.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/AnalyzerProfile.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/AnalyzerProfile.java Sun Jan 31 15:20:26 2010
@@ -27,12 +27,7 @@
* <p>
* SmartChineseAnalyzer has a built-in dictionary and stopword list out-of-box.
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
- *
+ * @lucene.experimental
*/
public class AnalyzerProfile {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/CharType.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/CharType.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/CharType.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/CharType.java Sun Jan 31 15:20:26 2010
@@ -19,11 +19,7 @@
/**
* Internal SmartChineseAnalyzer character type constants.
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class CharType {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SentenceTokenizer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SentenceTokenizer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SentenceTokenizer.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SentenceTokenizer.java Sun Jan 31 15:20:26 2010
@@ -31,11 +31,7 @@
* <p>
* The output tokens can then be broken into words with {@link WordTokenFilter}
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public final class SentenceTokenizer extends Tokenizer {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SmartChineseAnalyzer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SmartChineseAnalyzer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SmartChineseAnalyzer.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/SmartChineseAnalyzer.java Sun Jan 31 15:20:26 2010
@@ -52,11 +52,7 @@
* The included dictionary data is from <a href="http://www.ictclas.org">ICTCLAS1.0</a>.
* Thanks to ICTCLAS for their hard work, and for contributing the data under the Apache 2 License!
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public final class SmartChineseAnalyzer extends Analyzer {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/Utility.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/Utility.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/Utility.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/Utility.java Sun Jan 31 15:20:26 2010
@@ -21,11 +21,7 @@
/**
* SmartChineseAnalyzer utility constants and methods
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class Utility {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordSegmenter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordSegmenter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordSegmenter.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordSegmenter.java Sun Jan 31 15:20:26 2010
@@ -26,11 +26,7 @@
/**
* Segment a sentence of Chinese text into words.
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class WordSegmenter {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordTokenFilter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordTokenFilter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordTokenFilter.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordTokenFilter.java Sun Jan 31 15:20:26 2010
@@ -30,11 +30,7 @@
/**
* A {@link TokenFilter} that breaks sentences into words.
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public final class WordTokenFilter extends TokenFilter {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordType.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordType.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordType.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/WordType.java Sun Jan 31 15:20:26 2010
@@ -19,11 +19,7 @@
/**
* Internal SmartChineseAnalyzer token type constants
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class WordType {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/AbstractDictionary.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/AbstractDictionary.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/AbstractDictionary.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/AbstractDictionary.java Sun Jan 31 15:20:26 2010
@@ -26,11 +26,7 @@
* <p>
* Contains methods for dealing with GB2312 encoding.
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
abstract class AbstractDictionary {
/**
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BiSegGraph.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BiSegGraph.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BiSegGraph.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BiSegGraph.java Sun Jan 31 15:20:26 2010
@@ -30,11 +30,7 @@
* <p>
* For each start offset, a list of possible token pairs is stored.
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class BiSegGraph {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BigramDictionary.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BigramDictionary.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BigramDictionary.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/BigramDictionary.java Sun Jan 31 15:20:26 2010
@@ -34,11 +34,7 @@
/**
* SmartChineseAnalyzer Bigram dictionary.
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class BigramDictionary extends AbstractDictionary {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/HHMMSegmenter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/HHMMSegmenter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/HHMMSegmenter.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/HHMMSegmenter.java Sun Jan 31 15:20:26 2010
@@ -26,11 +26,7 @@
/**
* Finds the optimal segmentation of a sentence into Chinese words
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class HHMMSegmenter {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/PathNode.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/PathNode.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/PathNode.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/PathNode.java Sun Jan 31 15:20:26 2010
@@ -22,11 +22,7 @@
* <p>
* Used by {@link BiSegGraph} to maximize the segmentation with the Viterbi algorithm.
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class PathNode implements Comparable<PathNode> {
public double weight;
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegGraph.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegGraph.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegGraph.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegGraph.java Sun Jan 31 15:20:26 2010
@@ -27,11 +27,7 @@
* <p>
* For each start offset, a list of possible tokens is stored.
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class SegGraph {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegToken.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegToken.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegToken.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegToken.java Sun Jan 31 15:20:26 2010
@@ -23,11 +23,7 @@
/**
* SmartChineseAnalyzer internal token
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class SegToken {
/**
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenFilter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenFilter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenFilter.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenFilter.java Sun Jan 31 15:20:26 2010
@@ -25,11 +25,7 @@
* Filters a {@link SegToken} by converting full-width latin to half-width, then lowercasing latin.
* Additionally, all punctuation is converted into {@link Utility#COMMON_DELIMITER}
* </p>
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
public class SegTokenFilter {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenPair.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenPair.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenPair.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/SegTokenPair.java Sun Jan 31 15:20:26 2010
@@ -21,11 +21,7 @@
/**
* A pair of tokens in {@link SegGraph}
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class SegTokenPair {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/WordDictionary.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/WordDictionary.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/WordDictionary.java (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/WordDictionary.java Sun Jan 31 15:20:26 2010
@@ -35,12 +35,7 @@
/**
* SmartChineseAnalyzer Word Dictionary
- *
- * <p><font color="#FF0000">
- * WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental.
- * The APIs and file formats introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
- * </p>
+ * @lucene.experimental
*/
class WordDictionary extends AbstractDictionary {
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/package.html
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/package.html?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/package.html (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/hhmm/package.html Sun Jan 31 15:20:26 2010
@@ -23,11 +23,7 @@
SmartChineseAnalyzer Hidden Markov Model package.
</div>
<div>
-<font color="#FF0000">
-WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental. The APIs
-and file formats introduced here might change in the future and will not be supported anymore
-in such a case.
-</font>
+@lucene.experimental
</div>
</body>
</html>
Modified: lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html (original)
+++ lucene/java/trunk/contrib/analyzers/smartcn/src/java/org/apache/lucene/analysis/cn/smart/package.html Sun Jan 31 15:20:26 2010
@@ -24,11 +24,7 @@
Analyzer for Simplified Chinese, which indexes words.
</div>
<div>
-<font color="#FF0000">
-WARNING: The status of the analyzers/smartcn <b>analysis.cn.smart</b> package is experimental. The APIs
-and file formats introduced here might change in the future and will not be supported anymore
-in such a case.
-</font>
+@lucene.experimental
</div>
<div>
Three analyzers are provided for Chinese, each of which treats Chinese text in a different way.
Modified: lucene/java/trunk/contrib/ant/src/java/org/apache/lucene/ant/TextDocument.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/ant/src/java/org/apache/lucene/ant/TextDocument.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/ant/src/java/org/apache/lucene/ant/TextDocument.java (original)
+++ lucene/java/trunk/contrib/ant/src/java/org/apache/lucene/ant/TextDocument.java Sun Jan 31 15:20:26 2010
@@ -89,7 +89,7 @@
/**
*@return The contents value
- *@todo finish this method
+ *TODO: finish this method
*/
public String getContents() {
return contents;
Modified: lucene/java/trunk/contrib/benchmark/src/java/org/apache/lucene/benchmark/byTask/tasks/NearRealtimeReaderTask.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/benchmark/src/java/org/apache/lucene/benchmark/byTask/tasks/NearRealtimeReaderTask.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/benchmark/src/java/org/apache/lucene/benchmark/byTask/tasks/NearRealtimeReaderTask.java (original)
+++ lucene/java/trunk/contrib/benchmark/src/java/org/apache/lucene/benchmark/byTask/tasks/NearRealtimeReaderTask.java Sun Jan 31 15:20:26 2010
@@ -29,8 +29,7 @@
* single query (body: 1) sorted by docdate, and prints
* time to reopen and time to run the search.
*
- * <b>NOTE</b>: this is very experimental at this point, and
- * subject to change. It's also not generally usable, eg
+ * @lucene.experimental It's also not generally usable, eg
* you cannot change which query is executed.
*/
public class NearRealtimeReaderTask extends PerfTask {
Modified: lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/InstantiatedIndex.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/InstantiatedIndex.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/InstantiatedIndex.java (original)
+++ lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/InstantiatedIndex.java Sun Jan 31 15:20:26 2010
@@ -43,7 +43,7 @@
* results up to a 100 times faster than the file-centric RAMDirectory
* at the cost of greater RAM consumption.
* <p>
- * WARNING: This contrib is experimental and the APIs may change without warning.
+ * @lucene.experimental
* <p>
* There are no read and write locks in this store.
* {@link InstantiatedIndexReader} {@link InstantiatedIndexReader#isCurrent()} all the time
Modified: lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/package.html
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/package.html?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/package.html (original)
+++ lucene/java/trunk/contrib/instantiated/src/java/org/apache/lucene/store/instantiated/package.html Sun Jan 31 15:20:26 2010
@@ -22,7 +22,7 @@
<body>
<p>InstantiatedIndex, alternative RAM store for small corpora.</p>
-<p>WARNING: This contrib is experimental and the APIs may change without warning.</p>
+<p>@lucene.experimental</p>
<h2>Abstract</h2>
<p>
Modified: lucene/java/trunk/contrib/misc/src/java/org/apache/lucene/index/IndexSplitter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/misc/src/java/org/apache/lucene/index/IndexSplitter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/misc/src/java/org/apache/lucene/index/IndexSplitter.java (original)
+++ lucene/java/trunk/contrib/misc/src/java/org/apache/lucene/index/IndexSplitter.java Sun Jan 31 15:20:26 2010
@@ -41,8 +41,7 @@
* File{In,Out}putStream) so it will not work with non
* FSDirectory Directory impls.</p>
*
- * <p><b>NOTE</b>: The tool is experimental and might change
- * in incompatible ways in the next release. You can easily
+ * @lucene.experimental You can easily
* accidentally remove segments from your index so be
* careful!
*/
Modified: lucene/java/trunk/contrib/wikipedia/src/java/org/apache/lucene/wikipedia/analysis/WikipediaTokenizer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/contrib/wikipedia/src/java/org/apache/lucene/wikipedia/analysis/WikipediaTokenizer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/contrib/wikipedia/src/java/org/apache/lucene/wikipedia/analysis/WikipediaTokenizer.java (original)
+++ lucene/java/trunk/contrib/wikipedia/src/java/org/apache/lucene/wikipedia/analysis/WikipediaTokenizer.java Sun Jan 31 15:20:26 2010
@@ -36,8 +36,7 @@
* Wikipedia tutorial available at http://en.wikipedia.org/wiki/Wikipedia:Tutorial, but it may not be complete.
* <p/>
* <p/>
- * EXPERIMENTAL !!!!!!!!!
- * NOTE: This Tokenizer is considered experimental and the grammar is subject to change in the trunk and in follow up releases.
+ * @lucene.experimental
*/
public final class WikipediaTokenizer extends Tokenizer {
public static final String INTERNAL_LINK = "il";
Modified: lucene/java/trunk/src/java/org/apache/lucene/analysis/NumericTokenStream.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/analysis/NumericTokenStream.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/analysis/NumericTokenStream.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/analysis/NumericTokenStream.java Sun Jan 31 15:20:26 2010
@@ -82,8 +82,7 @@
* href="../search/NumericRangeQuery.html#precisionStepDesc"><code>precisionStep</code></a>
* parameter as well as how numeric fields work under the hood.</p>
*
- * <p><font color="red"><b>NOTE:</b> This API is experimental and
- * might change in incompatible ways in the next release.</font>
+ * @lucene.experimental
*
* @since 2.9
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/analysis/Token.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/analysis/Token.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/analysis/Token.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/analysis/Token.java Sun Jan 31 15:20:26 2010
@@ -454,14 +454,14 @@
}
/**
- * EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long.
* <p/>
*
* Get the bitset for any bits that have been set. This is completely distinct from {@link #type()}, although they do share similar purposes.
* The flags can be used to encode information about the token for use by other {@link org.apache.lucene.analysis.TokenFilter}s.
*
- *
+ *
* @return The bits
+ * @lucene.experimental While we think this is here to stay, we may want to change it to be a long.
*/
public int getFlags() {
return flags;
Modified: lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttribute.java Sun Jan 31 15:20:26 2010
@@ -23,10 +23,10 @@
/**
* This attribute can be used to pass different flags down the {@link Tokenizer} chain,
* eg from one TokenFilter to another one.
+ * @lucene.experimental While we think this is here to stay, we may want to change it to be a long.
*/
public interface FlagsAttribute extends Attribute {
/**
- * EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long.
* <p/>
*
* Get the bitset for any bits that have been set. This is completely distinct from {@link TypeAttribute#type()}, although they do share similar purposes.
Modified: lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttributeImpl.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttributeImpl.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttributeImpl.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/analysis/tokenattributes/FlagsAttributeImpl.java Sun Jan 31 15:20:26 2010
@@ -24,12 +24,12 @@
/**
* This attribute can be used to pass different flags down the tokenizer chain,
* eg from one TokenFilter to another one.
+ * @lucene.experimental While we think this is here to stay, we may want to change it to be a long.
*/
public class FlagsAttributeImpl extends AttributeImpl implements FlagsAttribute, Cloneable, Serializable {
private int flags = 0;
/**
- * EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long.
* <p/>
*
* Get the bitset for any bits that have been set. This is completely distinct from {@link TypeAttribute#type()}, although they do share similar purposes.
Modified: lucene/java/trunk/src/java/org/apache/lucene/document/NumericField.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/document/NumericField.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/document/NumericField.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/document/NumericField.java Sun Jan 31 15:20:26 2010
@@ -134,9 +134,7 @@
* values are returned as {@link String}s (according to
* <code>toString(value)</code> of the used data type).
*
- * <p><font color="red"><b>NOTE:</b> This API is
- * experimental and might change in incompatible ways in the
- * next release.</font>
+ * @lucene.experimental
*
* @since 2.9
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/CheckIndex.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/CheckIndex.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/CheckIndex.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/CheckIndex.java Sun Jan 31 15:20:26 2010
@@ -41,9 +41,7 @@
* <p>As this tool checks every byte in the index, on a large
* index it can take quite a long time to run.
*
- * <p><b>WARNING</b>: this tool and API is new and
- * experimental and is subject to suddenly change in the
- * next release. Please make a complete backup of your
+ * @lucene.experimental Please make a complete backup of your
* index before using this to fix your index!
*/
public class CheckIndex {
@@ -54,8 +52,7 @@
/**
* Returned from {@link #checkIndex()} detailing the health and status of the index.
*
- * <p><b>WARNING</b>: this API is new and experimental and is
- * subject to suddenly change in the next release.
+ * @lucene.experimental
**/
public static class Status {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/DirectoryReader.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/DirectoryReader.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/DirectoryReader.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/DirectoryReader.java Sun Jan 31 15:20:26 2010
@@ -925,7 +925,7 @@
/**
* Expert: return the IndexCommit that this reader has opened.
* <p/>
- * <p><b>WARNING</b>: this API is new and experimental and may suddenly change.</p>
+ * @lucene.experimental
*/
@Override
public IndexCommit getIndexCommit() throws IOException {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/FieldInvertState.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/FieldInvertState.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/FieldInvertState.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/FieldInvertState.java Sun Jan 31 15:20:26 2010
@@ -23,8 +23,7 @@
* being added to the index. The information collected in this class is
* also used to calculate the normalization factor for a field.
*
- * <p><b>WARNING</b>: This API is new and experimental, and may suddenly
- * change.</p>
+ * @lucene.experimental
*/
public final class FieldInvertState {
int position;
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsDocsConsumer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsDocsConsumer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsDocsConsumer.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsDocsConsumer.java Sun Jan 31 15:20:26 2010
@@ -20,7 +20,7 @@
import java.io.IOException;
/**
- * NOTE: this API is experimental and will likely change
+ * @lucene.experimental
*/
abstract class FormatPostingsDocsConsumer {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsFieldsConsumer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsFieldsConsumer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsFieldsConsumer.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsFieldsConsumer.java Sun Jan 31 15:20:26 2010
@@ -24,7 +24,7 @@
* actually do "something" with the postings (write it into
* the index in a specific format).
*
- * NOTE: this API is experimental and will likely change
+ * @lucene.experimental
*/
abstract class FormatPostingsFieldsConsumer {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsTermsConsumer.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsTermsConsumer.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsTermsConsumer.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/FormatPostingsTermsConsumer.java Sun Jan 31 15:20:26 2010
@@ -23,7 +23,7 @@
import org.apache.lucene.util.RamUsageEstimator;
/**
- * NOTE: this API is experimental and will likely change
+ * @lucene.experimental
*/
abstract class FormatPostingsTermsConsumer {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/IndexCommit.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/IndexCommit.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/IndexCommit.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/IndexCommit.java Sun Jan 31 15:20:26 2010
@@ -37,8 +37,7 @@
* associated with it. The segments file associated with a
* later index commit point would have a larger N.</p>
*
- * <p><b>WARNING</b>: This API is a new and experimental and
- * may suddenly change. </p>
+ * @lucene.experimental
*/
public abstract class IndexCommit {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/IndexReader.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/IndexReader.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/IndexReader.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/IndexReader.java Sun Jan 31 15:20:26 2010
@@ -1053,8 +1053,7 @@
* readers that correspond to a Directory with its own
* segments_N file.
*
- * <p><b>WARNING</b>: this API is new and experimental and
- * may suddenly change.</p>
+ * @lucene.experimental
*/
public IndexCommit getIndexCommit() throws IOException {
throw new UnsupportedOperationException("This reader does not support this method.");
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/IndexWriter.java Sun Jan 31 15:20:26 2010
@@ -360,8 +360,7 @@
* if you attempt to reopen any of those readers, you'll
* hit an {@link AlreadyClosedException}.</p>
*
- * <p><b>NOTE:</b> This API is experimental and might
- * change in incompatible ways in the next release.</p>
+ * @lucene.experimental
*
* @return IndexReader that covers entire index plus all
* changes made so far by this IndexWriter instance
@@ -4825,8 +4824,7 @@
* search, but will reduce search latency on opening a
* new near real-time reader after a merge completes.
*
- * <p><b>NOTE:</b> This API is experimental and might
- * change in incompatible ways in the next release.</p>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: warm is called before any deletes have
* been carried over to the merged segment. */
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/MergePolicy.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/MergePolicy.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/MergePolicy.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/MergePolicy.java Sun Jan 31 15:20:26 2010
@@ -51,8 +51,7 @@
* <p>The default MergePolicy is {@link
* LogByteSizeMergePolicy}.</p>
*
- * <p><b>NOTE:</b> This API is new and still experimental
- * (subject to change suddenly in the next release)</p>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: This class typically requires access to
* package-private APIs (e.g. <code>SegmentInfos</code>) to do its job;
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/MergeScheduler.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/MergeScheduler.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/MergeScheduler.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/MergeScheduler.java Sun Jan 31 15:20:26 2010
@@ -24,8 +24,7 @@
* selected by a {@link MergePolicy}. The default
* MergeScheduler is {@link ConcurrentMergeScheduler}.</p>
*
- * <p><b>NOTE:</b> This API is new and still experimental
- * (subject to change suddenly in the next release)</p>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: This class typically requires access to
* package-private APIs (eg, SegmentInfos) to do its job;
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfo.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfo.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfo.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfo.java Sun Jan 31 15:20:26 2010
@@ -32,8 +32,7 @@
* Information about a segment such as it's name, directory, and files related
* to the segment.
*
- * * <p><b>NOTE:</b> This API is new and still experimental
- * (subject to change suddenly in the next release)</p>
+ * @lucene.experimental
*/
public final class SegmentInfo {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfos.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfos.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfos.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/SegmentInfos.java Sun Jan 31 15:20:26 2010
@@ -40,8 +40,7 @@
* A collection of segmentInfo objects with methods for operating on
* those segments in relation to the file system.
*
- * <p><b>NOTE:</b> This API is new and still experimental
- * (subject to change suddenly in the next release)</p>
+ * @lucene.experimental
*/
public final class SegmentInfos extends Vector<SegmentInfo> {
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/SegmentReader.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/SegmentReader.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/SegmentReader.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/SegmentReader.java Sun Jan 31 15:20:26 2010
@@ -41,8 +41,7 @@
import org.apache.lucene.search.FieldCache; // not great (circular); used only to purge FieldCache entry on close
/**
- * <p><b>NOTE:</b> This API is new and still experimental
- * (subject to change suddenly in the next release)</p>
+ * @lucene.experimental
*/
public class SegmentReader extends IndexReader implements Cloneable {
protected boolean readOnly;
Modified: lucene/java/trunk/src/java/org/apache/lucene/index/SnapshotDeletionPolicy.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/index/SnapshotDeletionPolicy.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/index/SnapshotDeletionPolicy.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/index/SnapshotDeletionPolicy.java Sun Jan 31 15:20:26 2010
@@ -39,8 +39,7 @@
* snapshot held when a writer is closed will "survive"
* when the next writer is opened.
*
- * <p><b>WARNING</b>: This API is a new and experimental and
- * may suddenly change.</p> */
+ * @lucene.experimental */
public class SnapshotDeletionPolicy implements IndexDeletionPolicy {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/Collector.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/Collector.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/Collector.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/Collector.java Sun Jan 31 15:20:26 2010
@@ -116,8 +116,7 @@
* you need that behavior, use {@link
* PositiveScoresOnlyCollector}.</p>
*
- * <p><b>NOTE:</b> This API is experimental and might change
- * in incompatible ways in the next release.</p>
+ * @lucene.experimental
*
* @since 2.9
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/DefaultSimilarity.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/DefaultSimilarity.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/DefaultSimilarity.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/DefaultSimilarity.java Sun Jan 31 15:20:26 2010
@@ -29,8 +29,7 @@
* FieldInvertState#getLength()} - {@link
* FieldInvertState#getNumOverlap()}.
*
- * <p><b>WARNING</b>: This API is new and experimental, and may suddenly
- * change.</p> */
+ * @lucene.experimental */
@Override
public float computeNorm(String field, FieldInvertState state) {
final int numTerms;
@@ -85,8 +84,7 @@
* norm. By default this is false, meaning overlap
* tokens are counted just like non-overlap tokens.
*
- * <p><b>WARNING</b>: This API is new and experimental, and may suddenly
- * change.</p>
+ * @lucene.experimental
*
* @see #computeNorm
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/FieldCache.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/FieldCache.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/FieldCache.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/FieldCache.java Sun Jan 31 15:20:26 2010
@@ -496,12 +496,7 @@
/**
* EXPERT: A unique Identifier/Description for each item in the FieldCache.
* Can be useful for logging/debugging.
- * <p>
- * <b>EXPERIMENTAL API:</b> This API is considered extremely advanced
- * and experimental. It may be removed or altered w/o warning in future
- * releases
- * of Lucene.
- * </p>
+ * @lucene.experimental
*/
public static abstract class CacheEntry {
public abstract Object getReaderKey();
@@ -566,12 +561,7 @@
* associated with it has garbage collected will prevent the Value itself
* from being garbage collected when the Cache drops the WeakReference.
* </p>
- * <p>
- * <b>EXPERIMENTAL API:</b> This API is considered extremely advanced
- * and experimental. It may be removed or altered w/o warning in future
- * releases
- * of Lucene.
- * </p>
+ * @lucene.experimental
*/
public abstract CacheEntry[] getCacheEntries();
@@ -584,12 +574,7 @@
* It should not be relied on for "Cache maintenance" in general
* application code.
* </p>
- * <p>
- * <b>EXPERIMENTAL API:</b> This API is considered extremely advanced
- * and experimental. It may be removed or altered w/o warning in future
- * releases
- * of Lucene.
- * </p>
+ * @lucene.experimental
*/
public abstract void purgeAllCaches();
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparator.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparator.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparator.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparator.java Sun Jan 31 15:20:26 2010
@@ -79,8 +79,7 @@
* FieldDoc#fields} when returning the top results.
* </ul>
*
- * <b>NOTE:</b> This API is experimental and might change in
- * incompatible ways in the next release.
+ * @lucene.experimental
*/
public abstract class FieldComparator {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparatorSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparatorSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparatorSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/FieldComparatorSource.java Sun Jan 31 15:20:26 2010
@@ -23,8 +23,7 @@
/**
* Provides a {@link FieldComparator} for custom field sorting.
*
- * <b>NOTE:</b> This API is experimental and might change in
- * incompatible ways in the next release.
+ * @lucene.experimental
*
*/
public abstract class FieldComparatorSource implements Serializable {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/FieldValueHitQueue.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/FieldValueHitQueue.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/FieldValueHitQueue.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/FieldValueHitQueue.java Sun Jan 31 15:20:26 2010
@@ -26,9 +26,7 @@
* Uses <code>FieldCache.DEFAULT</code> for maintaining
* internal term lookup tables.
*
- * <b>NOTE:</b> This API is experimental and might change in
- * incompatible ways in the next release.
- *
+ * @lucene.experimental
* @since 2.9
* @see Searcher#search(Query,Filter,int,Sort)
* @see FieldCache
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/IndexSearcher.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/IndexSearcher.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/IndexSearcher.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/IndexSearcher.java Sun Jan 31 15:20:26 2010
@@ -86,9 +86,7 @@
/** Expert: directly specify the reader, subReaders and
* their docID starts.
*
- * <p><b>NOTE:</b> This API is experimental and
- * might change in incompatible ways in the next
- * release.</font></p> */
+ * @lucene.experimental */
public IndexSearcher(IndexReader reader, IndexReader[] subReaders, int[] docStarts) {
this.reader = reader;
this.subReaders = subReaders;
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeFilter.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeFilter.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeFilter.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeFilter.java Sun Jan 31 15:20:26 2010
@@ -39,9 +39,7 @@
* See {@link NumericRangeQuery} for details on how Lucene
* indexes and searches numeric valued fields.
*
- * <p><font color="red"><b>NOTE:</b> This API is experimental and
- * might change in incompatible ways in the next
- * release.</font>
+ * @lucene.experimental
*
* @since 2.9
**/
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeQuery.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeQuery.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeQuery.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/NumericRangeQuery.java Sun Jan 31 15:20:26 2010
@@ -75,8 +75,7 @@
* BooleanQuery rewrite methods without changing
* BooleanQuery's default max clause count.
*
- * <p><font color="red"><b>NOTE:</b> This API is experimental and
- * might change in incompatible ways in the next release.</font>
+ * @lucene.experimental
*
* <br><h3>How it works</h3>
*
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/Similarity.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/Similarity.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/Similarity.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/Similarity.java Sun Jan 31 15:20:26 2010
@@ -602,8 +602,7 @@
* {@link FieldInvertState#getLength()} as the second argument, and
* then multiplies this value by {@link FieldInvertState#getBoost()}.</p>
*
- * <p><b>WARNING</b>: This API is new and experimental and may
- * suddenly change.</p>
+ * @lucene.experimental
*
* @param field field name
* @param state current processing state for this field
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/SortField.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/SortField.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/SortField.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/SortField.java Sun Jan 31 15:20:26 2010
@@ -365,8 +365,7 @@
/** Returns the {@link FieldComparator} to use for
* sorting.
*
- * <b>NOTE:</b> This API is experimental and might change in
- * incompatible ways in the next release.
+ * @lucene.experimental
*
* @param numHits number of top hits the queue will store
* @param sortPos position of this SortField within {@link
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/SpanFilterResult.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/SpanFilterResult.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/SpanFilterResult.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/SpanFilterResult.java Sun Jan 31 15:20:26 2010
@@ -23,8 +23,7 @@
/**
* The results of a SpanQueryFilter. Wraps the BitSet and the position information from the SpanQuery
*
- *<p/>
- * NOTE: This API is still experimental and subject to change.
+ * @lucene.experimental
*
**/
public class SpanFilterResult {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/TopFieldCollector.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/TopFieldCollector.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/TopFieldCollector.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/TopFieldCollector.java Sun Jan 31 15:20:26 2010
@@ -30,8 +30,7 @@
* See the {@link #create(org.apache.lucene.search.Sort, int, boolean, boolean, boolean, boolean)} method
* for instantiating a TopFieldCollector.
*
- * <p><b>NOTE:</b> This API is experimental and might change in
- * incompatible ways in the next release.</p>
+ * @lucene.experimental
*/
public abstract class TopFieldCollector extends TopDocsCollector<Entry> {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/ByteFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/ByteFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/ByteFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/ByteFieldSource.java Sun Jan 31 15:20:26 2010
@@ -29,10 +29,7 @@
* using <code>getBytes()</code> and makes those values
* available as other numeric types, casting as needed.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* @see org.apache.lucene.search.function.FieldCacheSource for requirements
* on the field.
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/CustomScoreQuery.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/CustomScoreQuery.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/CustomScoreQuery.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/CustomScoreQuery.java Sun Jan 31 15:20:26 2010
@@ -42,10 +42,7 @@
* </ol>
* Subclasses can modify the computation by overriding {@link #customScore(int, float, float)}.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*/
public class CustomScoreQuery extends Query {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/DocValues.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/DocValues.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/DocValues.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/DocValues.java Sun Jan 31 15:20:26 2010
@@ -25,10 +25,7 @@
* {@link org.apache.lucene.search.function.ValueSource ValueSuorce}
* for a particular field and reader.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
*
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldCacheSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldCacheSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldCacheSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldCacheSource.java Sun Jan 31 15:20:26 2010
@@ -34,10 +34,7 @@
* <p>
* Document with no tokens in this field are assigned the <code>Zero</code> value.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: with the switch in 2.9 to segment-based
* searching, if {@link #getValues} is invoked with a
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldScoreQuery.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldScoreQuery.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldScoreQuery.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/FieldScoreQuery.java Sun Jan 31 15:20:26 2010
@@ -52,10 +52,7 @@
* otherwise, for instance if for each query a new index reader is opened, large penalties would be
* paid for loading the field values into memory over and over again!
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*/
public class FieldScoreQuery extends ValueSourceQuery {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/FloatFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/FloatFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/FloatFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/FloatFieldSource.java Sun Jan 31 15:20:26 2010
@@ -29,10 +29,7 @@
* using <code>getFloats()</code> and makes those values
* available as other numeric types, casting as needed.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* @see org.apache.lucene.search.function.FieldCacheSource for requirements
* on the field.
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/IntFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/IntFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/IntFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/IntFieldSource.java Sun Jan 31 15:20:26 2010
@@ -29,10 +29,7 @@
* using <code>getInts()</code> and makes those values
* available as other numeric types, casting as needed.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* @see org.apache.lucene.search.function.FieldCacheSource for requirements
* on the field.
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/OrdFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/OrdFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/OrdFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/OrdFieldSource.java Sun Jan 31 15:20:26 2010
@@ -39,10 +39,7 @@
* when other documents are inserted or deleted,
* or if a MultiSearcher is used.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: with the switch in 2.9 to segment-based
* searching, if {@link #getValues} is invoked with a
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/ReverseOrdFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/ReverseOrdFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/ReverseOrdFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/ReverseOrdFieldSource.java Sun Jan 31 15:20:26 2010
@@ -40,10 +40,7 @@
* when other documents are inserted or deleted,
* or if a MultiSearcher is used.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* <p><b>NOTE</b>: with the switch in 2.9 to segment-based
* searching, if {@link #getValues} is invoked with a
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/ShortFieldSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/ShortFieldSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/ShortFieldSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/ShortFieldSource.java Sun Jan 31 15:20:26 2010
@@ -29,10 +29,7 @@
* using <code>getShorts()</code> and makes those values
* available as other numeric types, casting as needed.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* @see org.apache.lucene.search.function.FieldCacheSource for requirements
* on the field.
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSource.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSource.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSource.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSource.java Sun Jan 31 15:20:26 2010
@@ -31,10 +31,7 @@
* <P>ValueSource implementations differ in RAM requirements: it would always be a factor
* of the number of documents, but for each document the number of bytes can be 1, 2, 4, or 8.
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
*
*/
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSourceQuery.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSourceQuery.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSourceQuery.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/ValueSourceQuery.java Sun Jan 31 15:20:26 2010
@@ -37,10 +37,7 @@
* <p>
* Score is set as: Score(doc,query) = query.getBoost()<sup>2</sup> * valueSource(doc).
*
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>search.function</b> package is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*/
public class ValueSourceQuery extends Query {
ValueSource valSrc;
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/function/package.html
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/function/package.html?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/function/package.html (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/function/package.html Sun Jan 31 15:20:26 2010
@@ -26,11 +26,7 @@
The <code>function</code> package provides tight control over documents scores.
</DIV>
<DIV>
-<font color="#FF0000">
-WARNING: The status of the <b>search.function</b> package is experimental. The APIs
-introduced here might change in the future and will not be supported anymore
-in such a case.
-</font>
+@lucene.experimental
</DIV>
<DIV>
Two types of queries are available in this package:
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadFunction.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadFunction.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadFunction.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadFunction.java Sun Jan 31 15:20:26 2010
@@ -18,16 +18,15 @@
import java.io.Serializable;
-
/**
- * An abstract class that defines a way for Payload*Query instances
- * to transform the cumulative effects of payload scores for a document.
- *
+ * An abstract class that defines a way for Payload*Query instances to transform
+ * the cumulative effects of payload scores for a document.
+ *
* @see org.apache.lucene.search.payloads.PayloadTermQuery for more information
- *
- * <p/>
- * This class and its derivations are experimental and subject to change
- *
+ *
+ * @lucene.experimental This class and its derivations are experimental and subject to
+ * change
+ *
**/
public abstract class PayloadFunction implements Serializable {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadSpanUtil.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadSpanUtil.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadSpanUtil.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/payloads/PayloadSpanUtil.java Sun Jan 31 15:20:26 2010
@@ -44,11 +44,7 @@
* Operates like Highlighter - IndexReader should only contain doc of interest,
* best to use MemoryIndex.
*
- * <p/>
- * <font color="#FF0000">
- * WARNING: The status of the <b>Payloads</b> feature is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
*/
public class PayloadSpanUtil {
Modified: lucene/java/trunk/src/java/org/apache/lucene/search/spans/Spans.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/search/spans/Spans.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/search/spans/Spans.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/search/spans/Spans.java Sun Jan 31 15:20:26 2010
@@ -66,10 +66,7 @@
* <br>
* Note that the return type is a collection, thus the ordering should not be relied upon.
* <br/>
- * <p><font color="#FF0000">
- * WARNING: The status of the <b>Payloads</b> feature is experimental.
- * The APIs introduced here might change in the future and will not be
- * supported anymore in such a case.</font>
+ * @lucene.experimental
*
* @return a List of byte arrays containing the data of this payload, otherwise null if isPayloadAvailable is false
* @throws java.io.IOException
Modified: lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexInput.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexInput.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexInput.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexInput.java Sun Jan 31 15:20:26 2010
@@ -22,7 +22,10 @@
import java.util.zip.Checksum;
/** Writes bytes through to a primary IndexOutput, computing
- * checksum as it goes. Note that you cannot use seek(). */
+ * checksum as it goes. Note that you cannot use seek().
+ *
+ * @lucene.internal
+ */
public class ChecksumIndexInput extends IndexInput {
IndexInput main;
Checksum digest;
Modified: lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexOutput.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexOutput.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexOutput.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/store/ChecksumIndexOutput.java Sun Jan 31 15:20:26 2010
@@ -22,7 +22,10 @@
import java.util.zip.Checksum;
/** Writes bytes through to a primary IndexOutput, computing
- * checksum. Note that you cannot use seek().*/
+ * checksum. Note that you cannot use seek().
+ *
+ * @lucene.internal
+ */
public class ChecksumIndexOutput extends IndexOutput {
IndexOutput main;
Checksum digest;
Modified: lucene/java/trunk/src/java/org/apache/lucene/store/FileSwitchDirectory.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/store/FileSwitchDirectory.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/store/FileSwitchDirectory.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/store/FileSwitchDirectory.java Sun Jan 31 15:20:26 2010
@@ -31,8 +31,7 @@
* to this class, and must allow multiple threads to call
* contains at once.</p>
*
- * <p><b>NOTE</b>: this API is new and experimental and is
- * subject to suddenly change in the next release.
+ * @lucene.experimental
*/
public class FileSwitchDirectory extends Directory {
Modified: lucene/java/trunk/src/java/org/apache/lucene/util/ArrayUtil.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/util/ArrayUtil.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/util/ArrayUtil.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/util/ArrayUtil.java Sun Jan 31 15:20:26 2010
@@ -19,6 +19,8 @@
/**
* Methods for manipulating arrays.
+ *
+ * @lucene.internal
*/
public final class ArrayUtil {
/*
Modified: lucene/java/trunk/src/java/org/apache/lucene/util/BitUtil.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/util/BitUtil.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/util/BitUtil.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/util/BitUtil.java Sun Jan 31 15:20:26 2010
@@ -18,6 +18,7 @@
package org.apache.lucene.util; // from org.apache.solr.util rev 555343
/** A variety of high efficiency bit twiddling routines.
+ * @lucene.internal
*/
public class BitUtil {
Modified: lucene/java/trunk/src/java/org/apache/lucene/util/CharacterUtils.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/util/CharacterUtils.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/util/CharacterUtils.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/util/CharacterUtils.java Sun Jan 31 15:20:26 2010
@@ -24,6 +24,8 @@
* {@link CharacterUtils} provides a unified interface to Character-related
* operations to implement backwards compatible character operations based on a
* {@link Version} instance.
+ *
+ * @lucene.internal
*/
public abstract class CharacterUtils {
private static final Java4CharacterUtils JAVA_4 = new Java4CharacterUtils();
Modified: lucene/java/trunk/src/java/org/apache/lucene/util/CloseableThreadLocal.java
URL: http://svn.apache.org/viewvc/lucene/java/trunk/src/java/org/apache/lucene/util/CloseableThreadLocal.java?rev=905057&r1=905056&r2=905057&view=diff
==============================================================================
--- lucene/java/trunk/src/java/org/apache/lucene/util/CloseableThreadLocal.java (original)
+++ lucene/java/trunk/src/java/org/apache/lucene/util/CloseableThreadLocal.java Sun Jan 31 15:20:26 2010
@@ -48,6 +48,8 @@
* {@link #close} takes care of all
* threads. You should not call {@link #close} until all
* threads are done using the instance.
+ *
+ * @lucene.internal
*/
public class CloseableThreadLocal<T> implements Closeable {