hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Oleg Kalnichevski <ol...@apache.org>
Subject Re: Javadoc with Java 8
Date Thu, 21 Aug 2014 13:28:57 GMT
On Thu, 2014-08-21 at 14:54 +0200, Francois-Xavier Bonnet wrote:
> Hi Oleg,
> 
> When do you need it to be done?
> 
> 

There is no time-line for that. This needs to be done before 5.0 is
branched out in order to minimize / reduce merge conflicts.

Oleg 

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



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message