Mailing-List: contact dev-help@hc.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "HttpComponents Project" <dev@hc.apache.org>
Received-SPF: pass (athena.apache.org: domain of sebbaz@gmail.com designates
 74.125.82.52 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <1403538983.8074.1.camel@ubuntu>
References: <1403528535.4337.4.camel@ubuntu>
	<CAOGo0VZPRuuJWv14swB1RV1xETVHpJDBiNJ_SKRQ6g5Bztfm4A@mail.gmail.com>
	<1403538983.8074.1.camel@ubuntu>
Date: Mon, 23 Jun 2014 17:40:46 +0100
Message-ID: 
 <CAOGo0VZoSvywANoyeRS_USwQZgQ7rm3h1e-j3F4YsY_wQjFAAQ@mail.gmail.com>
Subject: Re: Coming HttpClient 4.4 alpha1 release
From: sebb <sebbaz@gmail.com>
To: HttpComponents Project <dev@hc.apache.org>
Content-Type: text/plain; charset=UTF-8

On 23 June 2014 16:56, Oleg Kalnichevski <olegk@apache.org> wrote:
> On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
>> On 23 June 2014 14:02, Oleg Kalnichevski <olegk@apache.org> 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: 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