lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Muir (JIRA)" <>
Subject [jira] [Commented] (LUCENE-6224) move package.htmls to for better tooling support
Date Fri, 06 Feb 2015 23:21:34 GMT


Robert Muir commented on LUCENE-6224:

Note that this will do nothing about overview.html (which it seems doclint does not check,
and has the same leniency issue / java 8 regression). But there are much less of those, and
worst case we can avoid its use.

> move package.htmls to for better tooling support
> ------------------------------------------------------------------
>                 Key: LUCENE-6224
>                 URL:
>             Project: Lucene - Core
>          Issue Type: Task
>            Reporter: Robert Muir
> Today, on java8, if you typo a link in the package documentation of
(package.html) like this:
> {code}
> {@link TermQuery}
> {code}
> then javadoc will silently do the wrong thing, it will generate a <code>xxx</code>
block with no link at all.
> On the other hand, if instead we do it as, then it shows up in big
red letters as an error in my IDE, doclint catches it at compile time, etc, and we ensure
our links are doing what we want.
> {code}
>     [javac] /home/rmuir/workspace/trunk/lucene/core/src/java/org/apache/lucene/search/
error: reference not found
>     [javac]     {@link TermQuery}
> {code}
> I think we should cutover? this also helps us rely less on our own linting scripts long
term because now doclint is checking these files too.

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message