Apache
/
lucene
mirror of https://github.com/apache/lucene.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

fix all doclint warnings 

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1642259 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Robert Muir 2014-11-28 03:18:36 +00:00
parent b9ea4d0229
commit cd1783c58c
21 changed files with 110 additions and 108 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
lucene/codecs/src/java/org/apache/lucene/codecs/memory/DirectPostingsFormat.java
View File

@ -58,7 +58,7 @@ import org.apache.lucene.util.automaton.Transition;
* storage, but then at read time loads and stores all
* terms and postings directly in RAM as byte[], int[].
*
* <p><b><font color=red>WARNING</font></b>: This is
* <p><b>WARNING</b>: This is
* exceptionally RAM intensive: it makes no effort to
* compress the postings data, storing terms as separate
* byte[] and postings as separate int[], but as a result it

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextCodec.java
View File

@ -31,7 +31,7 @@ import org.apache.lucene.codecs.TermVectorsFormat;
/**
* plain text index format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public final class SimpleTextCodec extends Codec {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextCompoundFormat.java
View File

@ -44,7 +44,7 @@ import org.apache.lucene.util.StringHelper;
/**
* plain text compound format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextCompoundFormat extends CompoundFormat {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextDocValuesFormat.java
View File

@ -28,7 +28,7 @@ import org.apache.lucene.index.SegmentWriteState;
/**
* plain text doc values format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* <p>
* the .dat file contains the data.
* for numbers this is a "fixed-width" file, for example a single byte range:

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextFieldInfosFormat.java
View File

@ -42,7 +42,7 @@ import org.apache.lucene.util.StringHelper;
/**
* plaintext field infos format
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextFieldInfosFormat extends FieldInfosFormat {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextLiveDocsFormat.java
View File

@ -42,7 +42,7 @@ import org.apache.lucene.util.UnicodeUtil;
/**
* reads/writes plaintext live docs
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextLiveDocsFormat extends LiveDocsFormat {

6
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextNormsFormat.java
View File

@ -33,7 +33,7 @@ import org.apache.lucene.util.Accountable;
/**
* plain-text norms format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
*
* @lucene.experimental
*/
@ -53,7 +53,7 @@ public class SimpleTextNormsFormat extends NormsFormat {
/**
* Reads plain-text norms.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
*
* @lucene.experimental
*/
@ -100,7 +100,7 @@ public class SimpleTextNormsFormat extends NormsFormat {
/**
* Writes plain-text norms.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
*
* @lucene.experimental
*/

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextSegmentInfoFormat.java
View File

@ -43,7 +43,7 @@ import org.apache.lucene.util.Version;
/**
* plain text segments file format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextSegmentInfoFormat extends SegmentInfoFormat {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextStoredFieldsFormat.java
View File

@ -30,7 +30,7 @@ import org.apache.lucene.store.IOContext;
/**
* plain text stored fields format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextStoredFieldsFormat extends StoredFieldsFormat {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextStoredFieldsReader.java
View File

@ -46,7 +46,7 @@ import static org.apache.lucene.codecs.simpletext.SimpleTextStoredFieldsWriter.*
/**
* reads plaintext stored fields
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextStoredFieldsReader extends StoredFieldsReader {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextStoredFieldsWriter.java
View File

@ -34,7 +34,7 @@ import org.apache.lucene.util.IOUtils;
/**
* Writes plain-text stored fields.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextStoredFieldsWriter extends StoredFieldsWriter {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextTermVectorsFormat.java
View File

@ -30,7 +30,7 @@ import org.apache.lucene.store.IOContext;
/**
* plain text term vectors format.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextTermVectorsFormat extends TermVectorsFormat {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextTermVectorsReader.java
View File

@ -53,7 +53,7 @@ import static org.apache.lucene.codecs.simpletext.SimpleTextTermVectorsWriter.*;
/**
* Reads plain-text term vectors.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextTermVectorsReader extends TermVectorsReader {

2
lucene/codecs/src/java/org/apache/lucene/codecs/simpletext/SimpleTextTermVectorsWriter.java
View File

@ -33,7 +33,7 @@ import org.apache.lucene.util.IOUtils;
/**
* Writes plain-text term vectors.
* <p>
* <b><font color="red">FOR RECREATIONAL USE ONLY</font></B>
* <b>FOR RECREATIONAL USE ONLY</b>
* @lucene.experimental
*/
public class SimpleTextTermVectorsWriter extends TermVectorsWriter {

4
lucene/common-build.xml
View File

@ -372,8 +372,8 @@
<echo level="warning" message="WARN: Linting documentation HTML is not supported on this Java version (${build.java.runtime}) / JVM (${java.vm.name}). NOTHING DONE!"/>
</target>
<!-- for now disable doclint: -->
<property name="javadoc.args" value="-Xdoclint:none"/>
<!-- for now enable only some doclint: -->
<property name="javadoc.args" value="-Xdoclint:all -Xdoclint:-html -Xdoclint:-missing"/>
<!-- Import custom ANT tasks. -->
<import file="${common.dir}/tools/custom-tasks.xml" />

58
lucene/core/src/java/org/apache/lucene/search/similarities/TFIDFSimilarity.java
View File

@ -80,11 +80,11 @@ import org.apache.lucene.util.BytesRef;
* of the weighted query vectors <i>V(q)</i> and <i>V(d)</i>:
*
* <br>&nbsp;<br>
* <table cellpadding="2" cellspacing="2" border="0" align="center" style="width:auto" summary="formatting only">
* <table cellpadding="2" cellspacing="2" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="1" cellspacing="0" border="1" align="center" summary="formatting only">
* <table cellpadding="1" cellspacing="0" border="1" style="margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="2" cellspacing="2" border="0" align="center" summary="cosine similarity formula">
* <table cellpadding="2" cellspacing="2" border="0" style="margin-left:auto; margin-right:auto" summary="cosine similarity formula">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* cosine-similarity(q,d) &nbsp; = &nbsp;
@ -102,7 +102,7 @@ import org.apache.lucene.util.BytesRef;
* </table>
* </td></tr>
* <tr><td>
* <center><font size=-1><u>VSM Score</u></font></center>
* <center><u>VSM Score</u></center>
* </td></tr>
* </table>
* <br>&nbsp;<br>
@ -165,27 +165,27 @@ import org.apache.lucene.util.BytesRef;
* we get <i>Lucene's Conceptual scoring formula</i>:
*
* <br>&nbsp;<br>
* <table cellpadding="2" cellspacing="2" border="0" align="center" style="width:auto" summary="formatting only">
* <table cellpadding="2" cellspacing="2" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="1" cellspacing="0" border="1" align="center" summary="formatting only">
* <table cellpadding="1" cellspacing="0" border="1" style="margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="2" cellspacing="2" border="0" align="center" summary="formatting only">
* <table cellpadding="2" cellspacing="2" border="0" style="margin-left:auto; margin-right:auto" summary="formatting only">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* score(q,d) &nbsp; = &nbsp;
* <font color="#FF9933">coord-factor(q,d)</font> &middot; &nbsp;
* <font color="#CCCC00">query-boost(q)</font> &middot; &nbsp;
* <span style="color: #FF9933">coord-factor(q,d)</span> &middot; &nbsp;
* <span style="color: #CCCC00">query-boost(q)</span> &middot; &nbsp;
* </td>
* <td valign="middle" align="center">
* <table summary="Lucene conceptual scoring formula">
* <tr><td align="center" style="text-align: center"><small><font color="#993399">V(q)&nbsp;&middot;&nbsp;V(d)</font></small></td></tr>
* <tr><td align="center" style="text-align: center"><small><span style="color: #993399">V(q)&nbsp;&middot;&nbsp;V(d)</span></small></td></tr>
* <tr><td align="center" style="text-align: center">&ndash;&ndash;&ndash;&ndash;&ndash;&ndash;&ndash;&ndash;&ndash;</td></tr>
* <tr><td align="center" style="text-align: center"><small><font color="#FF33CC">|V(q)|</font></small></td></tr>
* <tr><td align="center" style="text-align: center"><small><span style="color: #FF33CC">|V(q)|</span></small></td></tr>
* </table>
* </td>
* <td valign="middle" align="right" rowspan="1">
* &nbsp; &middot; &nbsp; <font color="#3399FF">doc-len-norm(d)</font>
* &nbsp; &middot; &nbsp; <font color="#3399FF">doc-boost(d)</font>
* &nbsp; &middot; &nbsp; <span style="color: #3399FF">doc-len-norm(d)</span>
* &nbsp; &middot; &nbsp; <span style="color: #3399FF">doc-boost(d)</span>
* </td>
* </tr>
* </table>
@ -193,7 +193,7 @@ import org.apache.lucene.util.BytesRef;
* </table>
* </td></tr>
* <tr><td>
* <center><font size=-1><u>Lucene Conceptual Scoring Formula</u></font></center>
* <center><u>Lucene Conceptual Scoring Formula</u></center>
* </td></tr>
* </table>
* <br>&nbsp;<br>
@ -257,26 +257,26 @@ import org.apache.lucene.util.BytesRef;
* to those of the <i>conceptual</i> formula:
*
* <P>
* <table cellpadding="2" cellspacing="2" border="0" align="center" style="width:auto" summary="formatting only">
* <table cellpadding="2" cellspacing="2" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="" cellspacing="2" border="2" align="center" summary="formatting only">
* <table cellpadding="" cellspacing="2" border="2" style="margin-left:auto; margin-right:auto" summary="formatting only">
* <tr><td>
* <table cellpadding="2" cellspacing="2" border="0" align="center" summary="Lucene conceptual scoring formula">
* <table cellpadding="2" cellspacing="2" border="0" style="margin-left:auto; margin-right:auto" summary="Lucene conceptual scoring formula">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* score(q,d) &nbsp; = &nbsp;
* <A HREF="#formula_coord"><font color="#FF9933">coord(q,d)</font></A> &nbsp;&middot;&nbsp;
* <A HREF="#formula_queryNorm"><font color="#FF33CC">queryNorm(q)</font></A> &nbsp;&middot;&nbsp;
* <A HREF="#formula_coord"><span style="color: #FF9933">coord(q,d)</span></A> &nbsp;&middot;&nbsp;
* <A HREF="#formula_queryNorm"><span style="color: #FF33CC">queryNorm(q)</span></A> &nbsp;&middot;&nbsp;
* </td>
* <td valign="bottom" align="center" rowspan="1" style="text-align: center">
* <big><big><big>&sum;</big></big></big>
* </td>
* <td valign="middle" align="right" rowspan="1">
* <big><big>(</big></big>
* <A HREF="#formula_tf"><font color="#993399">tf(t in d)</font></A> &nbsp;&middot;&nbsp;
* <A HREF="#formula_idf"><font color="#993399">idf(t)</font></A><sup>2</sup> &nbsp;&middot;&nbsp;
* <A HREF="#formula_termBoost"><font color="#CCCC00">t.getBoost()</font></A>&nbsp;&middot;&nbsp;
* <A HREF="#formula_norm"><font color="#3399FF">norm(t,d)</font></A>
* <A HREF="#formula_tf"><span style="color: #993399">tf(t in d)</span></A> &nbsp;&middot;&nbsp;
* <A HREF="#formula_idf"><span style="color: #993399">idf(t)</span></A><sup>2</sup> &nbsp;&middot;&nbsp;
* <A HREF="#formula_termBoost"><span style="color: #CCCC00">t.getBoost()</span></A>&nbsp;&middot;&nbsp;
* <A HREF="#formula_norm"><span style="color: #3399FF">norm(t,d)</span></A>
* <big><big>)</big></big>
* </td>
* </tr>
@ -290,7 +290,7 @@ import org.apache.lucene.util.BytesRef;
* </table>
* </td></tr>
* <tr><td>
* <center><font size=-1><u>Lucene Practical Scoring Function</u></font></center>
* <center><u>Lucene Practical Scoring Function</u></center>
* </td></tr>
* </table>
*
@ -310,7 +310,7 @@ import org.apache.lucene.util.BytesRef;
* {@link org.apache.lucene.search.similarities.DefaultSimilarity#tf(float) DefaultSimilarity} is:
*
* <br>&nbsp;<br>
* <table cellpadding="2" cellspacing="2" border="0" align="center" style="width:auto" summary="term frequency computation">
* <table cellpadding="2" cellspacing="2" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="term frequency computation">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* {@link org.apache.lucene.search.similarities.DefaultSimilarity#tf(float) tf(t in d)} &nbsp; = &nbsp;
@ -335,7 +335,7 @@ import org.apache.lucene.util.BytesRef;
* {@link org.apache.lucene.search.similarities.DefaultSimilarity#idf(long, long) DefaultSimilarity} is:
*
* <br>&nbsp;<br>
* <table cellpadding="2" cellspacing="2" border="0" align="center" style="width:auto" summary="inverse document frequency computation">
* <table cellpadding="2" cellspacing="2" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="inverse document frequency computation">
* <tr>
* <td valign="middle" align="right">
* {@link org.apache.lucene.search.similarities.DefaultSimilarity#idf(long, long) idf(t)}&nbsp; = &nbsp;
@ -383,7 +383,7 @@ import org.apache.lucene.util.BytesRef;
* {@link org.apache.lucene.search.similarities.DefaultSimilarity#queryNorm(float) DefaultSimilarity}
* produces a <a href="http://en.wikipedia.org/wiki/Euclidean_norm#Euclidean_norm">Euclidean norm</a>:
* <br>&nbsp;<br>
* <table cellpadding="1" cellspacing="0" border="0" align="center" style="width:auto" summary="query normalization computation">
* <table cellpadding="1" cellspacing="0" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="query normalization computation">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* queryNorm(q) &nbsp; = &nbsp;
@ -409,7 +409,7 @@ import org.apache.lucene.util.BytesRef;
* computes this value as:
*
* <br>&nbsp;<br>
* <table cellpadding="1" cellspacing="0" border="0" align="center" style="width:auto" summary="sum of squared weights computation">
* <table cellpadding="1" cellspacing="0" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="sum of squared weights computation">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* {@link org.apache.lucene.search.Weight#getValueForNormalization() sumOfSquaredWeights} &nbsp; = &nbsp;
@ -475,7 +475,7 @@ import org.apache.lucene.util.BytesRef;
* If the document has multiple fields with the same name, all their boosts are multiplied together:
*
* <br>&nbsp;<br>
* <table cellpadding="1" cellspacing="0" border="0" align="center" style="width:auto" summary="index-time normalization">
* <table cellpadding="1" cellspacing="0" border="0" style="width:auto; margin-left:auto; margin-right:auto" summary="index-time normalization">
* <tr>
* <td valign="middle" align="right" rowspan="1">
* norm(t,d) &nbsp; = &nbsp;

112
lucene/core/src/java/org/apache/lucene/store/DataOutput.java
View File

@ -97,88 +97,88 @@ public abstract class DataOutput {
* <col width="64*">
* <col width="64*">
* <tr valign="top">
* <th align="left" width="25%">Value</th>
* <th align="left" width="25%">Byte 1</th>
* <th align="left" width="25%">Byte 2</th>
* <th align="left" width="25%">Byte 3</th>
* <th align="left">Value</th>
* <th align="left">Byte 1</th>
* <th align="left">Byte 2</th>
* <th align="left">Byte 3</th>
* </tr>
* <tr valign="bottom">
* <td width="25%">0</td>
* <td width="25%"><kbd>00000000</kbd></td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td>0</td>
* <td><kbd>00000000</kbd></td>
* <td></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">1</td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td>1</td>
* <td><kbd>00000001</kbd></td>
* <td></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">2</td>
* <td width="25%"><kbd>00000010</kbd></td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td>2</td>
* <td><kbd>00000010</kbd></td>
* <td></td>
* <td></td>
* </tr>
* <tr>
* <td valign="top" width="25%">...</td>
* <td valign="bottom" width="25%"></td>
* <td valign="bottom" width="25%"></td>
* <td valign="bottom" width="25%"></td>
* <td valign="top">...</td>
* <td valign="bottom"></td>
* <td valign="bottom"></td>
* <td valign="bottom"></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">127</td>
* <td width="25%"><kbd>01111111</kbd></td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td>127</td>
* <td><kbd>01111111</kbd></td>
* <td></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">128</td>
* <td width="25%"><kbd>10000000</kbd></td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td width="25%"></td>
* <td>128</td>
* <td><kbd>10000000</kbd></td>
* <td><kbd>00000001</kbd></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">129</td>
* <td width="25%"><kbd>10000001</kbd></td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td width="25%"></td>
* <td>129</td>
* <td><kbd>10000001</kbd></td>
* <td><kbd>00000001</kbd></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">130</td>
* <td width="25%"><kbd>10000010</kbd></td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td width="25%"></td>
* <td>130</td>
* <td><kbd>10000010</kbd></td>
* <td><kbd>00000001</kbd></td>
* <td></td>
* </tr>
* <tr>
* <td valign="top" width="25%">...</td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td width="25%"></td>
* <td valign="top">...</td>
* <td></td>
* <td></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">16,383</td>
* <td width="25%"><kbd>11111111</kbd></td>
* <td width="25%"><kbd>01111111</kbd></td>
* <td width="25%"></td>
* <td>16,383</td>
* <td><kbd>11111111</kbd></td>
* <td><kbd>01111111</kbd></td>
* <td></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">16,384</td>
* <td width="25%"><kbd>10000000</kbd></td>
* <td width="25%"><kbd>10000000</kbd></td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td>16,384</td>
* <td><kbd>10000000</kbd></td>
* <td><kbd>10000000</kbd></td>
* <td><kbd>00000001</kbd></td>
* </tr>
* <tr valign="bottom">
* <td width="25%">16,385</td>
* <td width="25%"><kbd>10000001</kbd></td>
* <td width="25%"><kbd>10000000</kbd></td>
* <td width="25%"><kbd>00000001</kbd></td>
* <td>16,385</td>
* <td><kbd>10000001</kbd></td>
* <td><kbd>10000000</kbd></td>
* <td><kbd>00000001</kbd></td>
* </tr>
* <tr>
* <td valign="top" width="25%">...</td>
* <td valign="bottom" width="25%"></td>
* <td valign="bottom" width="25%"></td>
* <td valign="bottom" width="25%"></td>
* <td valign="top">...</td>
* <td valign="bottom"></td>
* <td valign="bottom"></td>
* <td valign="bottom"></td>
* </tr>
* </table>
* <p>This provides compression while still being efficient to decode.</p>

4
lucene/core/src/java/org/apache/lucene/store/NIOFSDirectory.java
View File

@ -41,14 +41,14 @@ import java.util.concurrent.Future; // javadoc
* for details.
* </p>
* <p>
* <font color="red"><b>NOTE:</b> Accessing this class either directly or
* <b>NOTE:</b> Accessing this class either directly or
* indirectly from a thread while it's interrupted can close the
* underlying file descriptor immediately if at the same time the thread is
* blocked on IO. The file descriptor will remain closed and subsequent access
* to {@link NIOFSDirectory} will throw a {@link ClosedChannelException}. If
* your application uses either {@link Thread#interrupt()} or
* {@link Future#cancel(boolean)} you should use {@code RAFDirectory} in
* favor of {@link NIOFSDirectory}.</font>
* favor of {@link NIOFSDirectory}.
* </p>
*/
public class NIOFSDirectory extends FSDirectory {

4
lucene/core/src/java/org/apache/lucene/util/AttributeSource.java
View File

@ -173,12 +173,12 @@ public class AttributeSource {
}
/** <b>Expert:</b> Adds a custom AttributeImpl instance with one or more Attribute interfaces.
* <p><font color="red"><b>Please note:</b> It is not guaranteed, that <code>att</code> is added to
* <p><b>NOTE:</b> It is not guaranteed, that <code>att</code> is added to
* the <code>AttributeSource</code>, because the provided attributes may already exist.
* You should always retrieve the wanted attributes using {@link #getAttribute} after adding
* with this method and cast to your class.
* The recommended way to use custom implementations is using an {@link AttributeFactory}.
* </font></p>
* </p>
*/
public final void addAttributeImpl(final AttributeImpl att) {
final Class<? extends AttributeImpl> clazz = att.getClass();

2
lucene/spatial/src/java/org/apache/lucene/spatial/prefix/tree/LegacyPrefixTree.java
View File

@ -25,7 +25,7 @@ import org.apache.lucene.util.BytesRef;
import java.util.Arrays;
/** The base for the original two SPT's: Geohash & Quad. Don't subclass this for new SPTs.
/** The base for the original two SPT's: Geohash and Quad. Don't subclass this for new SPTs.
* @lucene.internal */
abstract class LegacyPrefixTree extends SpatialPrefixTree {
public LegacyPrefixTree(SpatialContext ctx, int maxLevels) {

2
solr/common-build.xml
View File

@ -29,6 +29,8 @@
<property name="javac.source" value="1.8"/>
<property name="javac.target" value="1.8"/>
<property name="javac.args" value=""/>
<!-- for now disable doclint: -->
<property name="javadoc.args" value="-Xdoclint:none"/>
<property name="dest" location="${common-solr.dir}/build" />
<property name="build.dir" location="${dest}/${ant.project.name}"/>