You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by Oleg Kalnichevski <ol...@apache.org> on 2014/06/23 15:02:15 UTC
Coming HttpClient 4.4 alpha1 release
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
If I hear no complaints I'll proceed with building release packages
tomorrow.
Cheers
Oleg
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org
Re: Coming HttpClient 4.4 alpha1 release
Posted by Oleg Kalnichevski <ol...@apache.org>.
On Mon, 2014-06-23 at 20:38 +0100, sebb wrote:
...
> >> > ...
> >> >
> >> >> 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?
> >>
> >
> > Naturally. That is the whole point of having alpha releases, is that
> > not?
>
> In which case, it should be stated clearly in the RN that all @since
> 4.4 methods may change.
>
Which is the same as clearly stating that water is wet. The whole point
of having releases qualified as ALPHA is to indicate their experimental
status.
Oleg
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org
Re: Coming HttpClient 4.4 alpha1 release
Posted by sebb <se...@gmail.com>.
On 23 June 2014 20:31, Oleg Kalnichevski <ol...@apache.org> wrote:
> On Mon, 2014-06-23 at 17:40 +0100, sebb wrote:
>> On 23 June 2014 16:56, Oleg Kalnichevski <ol...@apache.org> wrote:
>> > On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
>> >> On 23 June 2014 14:02, Oleg Kalnichevski <ol...@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?
>>
>
> Naturally. That is the whole point of having alpha releases, is that
> not?
In which case, it should be stated clearly in the RN that all @since
4.4 methods may change.
But I would expect some kind of categorisation of which methods are
really experimental and which are clearly not.
> 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
Re: Coming HttpClient 4.4 alpha1 release
Posted by Oleg Kalnichevski <ol...@apache.org>.
On Mon, 2014-06-23 at 17:40 +0100, sebb wrote:
> On 23 June 2014 16:56, Oleg Kalnichevski <ol...@apache.org> wrote:
> > On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
> >> On 23 June 2014 14:02, Oleg Kalnichevski <ol...@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?
>
Naturally. That is the whole point of having alpha releases, is that
not?
Oleg
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org
Re: Coming HttpClient 4.4 alpha1 release
Posted by sebb <se...@gmail.com>.
On 23 June 2014 16:56, Oleg Kalnichevski <ol...@apache.org> wrote:
> On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
>> On 23 June 2014 14:02, Oleg Kalnichevski <ol...@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
Re: Coming HttpClient 4.4 alpha1 release
Posted by Oleg Kalnichevski <ol...@apache.org>.
On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
> On 23 June 2014 14:02, Oleg Kalnichevski <ol...@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.
Oleg
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org
Re: Coming HttpClient 4.4 alpha1 release
Posted by sebb <se...@gmail.com>.
On 23 June 2014 14:02, Oleg Kalnichevski <ol...@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.
1)
"This release also includes all fixes from the stable 4.3.x release branch."
I think this needs qualification as to the cut-off date / revision of
the branch.
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.
> If I hear no complaints I'll proceed with building release packages
> tomorrow.
>
> Cheers
>
> 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