hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Francois-Xavier Bonnet <francois-xavier.bon...@centraliens.net>
Subject Re: Javadoc with Java 8
Date Thu, 21 Aug 2014 12:54:43 GMT
Hi Oleg,

When do you need it to be done?


2014-08-21 14:13 GMT+02:00 Oleg Kalnichevski <olegk@apache.org>:

> 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.
>
> 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
> <http://t.signauxtrois.com/link?url=http%3A%2F%2Fblog.joda.org%2F2014%2F02%2Fturning-off-doclint-in-jdk-8-javadoc.html&ukey=agxzfnNpZ25hbHNjcnhyGAsSC1VzZXJQcm9maWxlGICAwI6v44MLDA&k=edd256ca-f7cd-4d18-ed0e-0bed42b5499a>
> > >
> > > ---------------------------------------------------------------------
> > > 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
>
>


2014-08-21 14:13 GMT+02:00 Oleg Kalnichevski <olegk@apache.org>:

> 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.
>
> 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
>
>

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