hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: Javadoc with Java 8
Date Thu, 21 Aug 2014 06:43:08 GMT
I think we should not disable doclint on Java 8.

Gary


On Wed, Aug 20, 2014 at 12:34 PM, sebb <sebbaz@gmail.com> wrote:

> The Javadoc that comes with Java 8 is very picky, and generates errors
> (rather than warnings) for all sorts of incorrect tags - for example
> <br/> and <p/> [1]
>
> This new doclint behaviour can be disabled by providing the command-line
> param
>
> -Xdoclint:none
>
> Unfortunately this causes Javadoc 7 to complain...
>
> Ideally, we should gradually work through the Javadoc fixing the errors.
>
> In the meantime, I have changed Continuum to build http core using
> Java 7 (it was defaulting to Java8).
>
> It would be possible to update the poms to conditionally suppress
> doclint for Java 8, but I'm not sure that is the best approach.
>
> [1] http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
> For additional commands, e-mail: dev-help@hc.apache.org
>
>


-- 
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition
<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message