On 23 June 2014 16:56, Oleg Kalnichevski <[email protected]> wrote: > On Mon, 2014-06-23 at 16:38 +0100, sebb wrote: >> On 23 June 2014 14:02, Oleg Kalnichevski <[email protected]> wrote: >> > Folks >> > >> > I would like to release HttpClient 4.4 alpha1 by the end of the week. >> > I'll be away for the first two week of July and ideally would like to >> > get the release done before that. >> > >> > Please have a look at the release notes and feel free to improve them: >> > >> > http://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk/RELEASE_NOTES.txt >> >> A couple of comments. >> > > ... > >> 2) >> "Please note that new features included in this release are still >> considered experimental and >> their API may change in the future 4.4 alpha and beta releases." >> >> I think this also needs to be made more specific, e.g. by adding a >> note to the sections which detail the the new features. >> Ideally the Javadoc should also state which features are experimental. >> > > All new features are marked with @since 4.4 tag in Javadocs.
But are ALL the @since 4.4 methods subject to change? For examle, Content.asString(Charset charset) does not seem likely to change. Likewies AuthScope.getOrigin() and all the new methods in Executor. I think the RN need to be more specific, otherwise it is making devs jobs much harder. > Oleg > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
