[
https://issues.apache.org/jira/browse/LUCENE-6917?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15055613#comment-15055613
]
Ishan Chattopadhyaya commented on LUCENE-6917:
----------------------------------------------
I was trying to run a single test case for Solr,
{{ant test -Dtestcase=SolrExampleXMLTest}}
I see some javadocs failures related to this commit:
{code}
compile-core:
[javac] Compiling 80 source files to
/home/ishan/code/lucene-solr-svn/lucene/build/core/classes/java
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DateTools.java:109:
error: invalid use of @throws
[javac] * @throws ParseException if <code>dateString</code> is not in
the
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DateTools.java:123:
error: invalid use of @throws
[javac] * @throws ParseException if <code>dateString</code> is not in
the
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DimensionalBinaryField.java:97:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or value
is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DimensionalDoubleField.java:81:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or value
is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DimensionalFloatField.java:81:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or value
is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DimensionalIntField.java:81:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or value
is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/DimensionalLongField.java:81:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or value
is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:87:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if either the name or type
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:106:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if either the name or type
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:109:
error: invalid use of @throws
[javac] * @throws NullPointerException if the reader is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:138:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if either the name or type
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:141:
error: invalid use of @throws
[javac] * @throws NullPointerException if the tokenStream is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:171:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null,
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:173:
error: invalid use of @throws
[javac] * @throws NullPointerException if the type is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:189:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null,
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:191:
error: invalid use of @throws
[javac] * @throws NullPointerException if the type is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:205:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null,
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:207:
error: invalid use of @throws
[javac] * @throws NullPointerException if the type is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:228:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if either the name or value
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:231:
error: invalid use of @throws
[javac] * @throws NullPointerException if the type is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/Field.java:445:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if this field is not indexed,
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:119:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:142:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:166:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:190:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:214:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:238:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:261:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:284:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:299:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:323:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if precisionStep is less than
1.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:324:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/FieldType.java:455:
error: invalid use of @throws
[javac] * @throws IllegalStateException if this FieldType is frozen
against
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyDoubleField.java:149:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyDoubleField.java:162:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or type is
null, or
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyFloatField.java:151:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyFloatField.java:164:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or type is
null, or
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyIntField.java:151:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyIntField.java:164:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or type is
null, or
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyLongField.java:159:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null.
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/LegacyLongField.java:172:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name or type is
null, or
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/document/SortedNumericDocValuesField.java:60:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if the field name is null
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/index/FieldInfos.java:184:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException if fieldNumber is negative
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/CachingCollector.java:377:
error: invalid use of @throws
[javac] * @throws IllegalStateException
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/CachingCollector.java:380:
error: invalid use of @throws
[javac] * @throws IllegalArgumentException
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/Weight.java:85:
error: invalid use of @throws
[javac] * @throws IOException if an {@link IOException} occurs
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/Weight.java:114:
error: invalid use of @throws
[javac] * @throws IOException if there is a low-level I/O error
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/Weight.java:131:
error: invalid use of @throws
[javac] * @throws IOException if there is a low-level I/O error
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/spans/SpanWeight.java:83:
error: invalid use of @throws
[javac] * @throws IOException on error
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/spans/SpanWeight.java:115:
error: invalid use of @throws
[javac] * @throws IOException on error
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/search/spans/SpanWeight.java:145:
error: invalid use of @throws
[javac] * @throws IOException on error
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/util/LegacyNumericUtils.java:194:
error: invalid use of @throws
[javac] * @throws NumberFormatException if the supplied {@link BytesRef}
is
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/util/LegacyNumericUtils.java:206:
error: invalid use of @throws
[javac] * @throws NumberFormatException if the supplied {@link BytesRef}
is
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/util/LegacyNumericUtils.java:220:
error: invalid use of @throws
[javac] * @throws NumberFormatException if the supplied {@link BytesRef}
is
[javac] ^
[javac]
/home/ishan/code/lucene-solr-svn/lucene/core/src/java/org/apache/lucene/util/LegacyNumericUtils.java:244:
error: invalid use of @throws
[javac] * @throws NumberFormatException if the supplied {@link BytesRef}
is
[javac] ^
[javac] Note: Some input files use or override a deprecated API.
[javac] Note: Recompile with -Xlint:deprecation for details.
[javac] 55 errors
{code}
Any ideas, please? Apologies, I don't have much understanding of these doclint
failures. Is there something wrong with my setup?
> Deprecate and rename NumericField/RangeQuery to LegacyNumeric
> -------------------------------------------------------------
>
> Key: LUCENE-6917
> URL: https://issues.apache.org/jira/browse/LUCENE-6917
> Project: Lucene - Core
> Issue Type: Improvement
> Reporter: Michael McCandless
> Assignee: Michael McCandless
> Fix For: 6.0
>
> Attachments: LUCENE-6917-broken-javadocs.patch, LUCENE-6917.patch,
> LUCENE-6917.patch, LUCENE-6917.patch
>
>
> DimensionalValues seems to be better across the board (indexing time,
> indexing size, search-speed, search-time heap required) than NumericField, at
> least in my testing so far.
> I think for 6.0 we should move {{IntField}}, {{LongField}}, {{FloatField}},
> {{DoubleField}} and {{NumericRangeQuery}} to {{backward-codecs}}, and rename
> with {{Legacy}} prefix?
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]