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 15:52:50 GMT
On Thu, Aug 21, 2014 at 8:13 AM, Oleg Kalnichevski <olegk@apache.org> wrote:

> On Thu, 2014-08-21 at 02:43 -0400, Gary Gregory wrote:
> > I think we should not disable doclint on Java 8.
> >
> > Gary
> >
>
> Folks,
>
> I can take care of javadoc cleanups for HttpCore, as I would like to
> branch out 5.0 development branch sometime soon. I would really
> appreciate if someone could do the same for HttpClient or
> HttpAsyncClient.
>

I dd HttpClient's modules and some other bits in other modules.

Gary

>
> Cheers
>
> Oleg
>
> >
> > 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
> > >
> > >
> >
> >
>
>
>
> ---------------------------------------------------------------------
> 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