Github user jpountz commented on a diff in the pull request:
https://github.com/apache/lucene-solr/pull/525#discussion_r241754530
--- Diff:
lucene/core/src/java/org/apache/lucene/codecs/lucene70/package-info.java ---
@@ -284,12 +284,12 @@
* <td>Stores additional per-position metadata information such as
character offsets and user payloads</td>
* </tr>
* <tr>
- * <td>{@link org.apache.lucene.codecs.lucene70.Lucene70NormsFormat
Norms}</td>
+ * <td>org.apache.lucene.codecs.lucene70.Lucene70NormsFormat Norms</td>
* <td>.nvd, .nvm</td>
* <td>Encodes length and boost factors for docs and fields</td>
* </tr>
* <tr>
- * <td>{@link org.apache.lucene.codecs.lucene70.Lucene70DocValuesFormat
Per-Document Values}</td>
+ * <td>org.apache.lucene.codecs.lucene70.Lucene70DocValuesFormat
Per-Document Values</td>
* <td>.dvd, .dvm</td>
* <td>Encodes additional scoring factors or other per-document
information.</td>
* </tr>
--- End diff --
Actually we could remove most of this to simplify. Only the current codec
needs to have a good description if its file formats. See eg. other
oal.codecs.luceneXX packages which have minimal javadocs.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
