You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by sebb <se...@gmail.com> on 2010/03/07 00:31:46 UTC
Re: [VOTE] Javadocs for current releases - CANCELLED
Whilst preparing to release the Javadoc archives I discovered that the
Javadocs we voted to release don't include all the modules.
The httpmime and httpcore-nio modules are not included in the
client/core Javadocs.
And although I created them as separate archives, I stupidly forgot to
put them in the directory so they weren't part of the vote
It looks like we actually need two sets of Javadocs, one for Maven
(which is what I started creating) and another for release downloads
which are combined Javadocs.
The combined Javadoc archives have different names too.
Sorry for all the noise.
I'll try again - hopefully better luck next time!
On 01/03/2010, sebb <se...@gmail.com> wrote:
> I've created Javadoc jars for all the current releases and uploaded them to:
>
> http://people.apache.org/~sebb/hc-javadoc/
>
> I think it would be useful to upload these to Maven and the dist
> directory, so I guess we need to vote on them.
>
> Since they are only documentation, I've not bothered creating sigs for
> them, but I can do so if it is felt necessary.
>
> [ ] +1 Release the Javadoc jars
> [ ] -1 I am against releasing the javadoc jars (must include a reason).
>
> Vote will remain open for at least 72 hours.
>
> Note: the intention is to add the 4.0.1 Javadocs to the site at some
> point, but I have yet to work out how best to do that.
>
>
> S///
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org
Re: [VOTE] Javadocs for current releases - CANCELLED
Posted by sebb <se...@gmail.com>.
On 07/03/2010, Oleg Kalnichevski <ol...@apache.org> wrote:
> On Sat, 2010-03-06 at 23:31 +0000, sebb wrote:
> > Whilst preparing to release the Javadoc archives I discovered that the
> > Javadocs we voted to release don't include all the modules.
> >
> > The httpmime and httpcore-nio modules are not included in the
> > client/core Javadocs.
>
>
> HttpClient does not depend on HttpCore NIO, so there is no need to
> include its javadocs. Moreover, I would consider linking to the HttpCore
> javadocs at the hc.apache.org as sufficient. There is no need to bundle
> javadocs of dependencies.
>
>
> > And although I created them as separate archives, I stupidly forgot to
> > put them in the directory so they weren't part of the vote
> >
> > It looks like we actually need two sets of Javadocs, one for Maven
> > (which is what I started creating) and another for release downloads
> > which are combined Javadocs.
>
>
> Do not worry about javadocs for the web site for the time being. They
> can be deployed without a release vote at any point of time.
I'm not thinking of the website yet.
The non-Maven release archives have different names from the Maven
archives; I think it's important that the Javadoc archives have the
same name prefix as the binary archives.
Creating aggregate Javadoc jars automatically creates the correct name prefix.
There was actually a further problem, in that the archives did not
have N&L files in them.
Perhaps not critical for documentation, but I'd like to sort that out.
However I'm having problems at the moment trying to persuade Maven to
execute the antrun task to do this as part of the jar process. It may
have to be done as a separate step.
> Oleg
>
>
> >
> > The combined Javadoc archives have different names too.
> >
> > Sorry for all the noise.
> >
> > I'll try again - hopefully better luck next time!
> >
> > On 01/03/2010, sebb <se...@gmail.com> wrote:
> > > I've created Javadoc jars for all the current releases and uploaded them to:
> > >
> > > http://people.apache.org/~sebb/hc-javadoc/
> > >
> > > I think it would be useful to upload these to Maven and the dist
> > > directory, so I guess we need to vote on them.
> > >
> > > Since they are only documentation, I've not bothered creating sigs for
> > > them, but I can do so if it is felt necessary.
> > >
> > > [ ] +1 Release the Javadoc jars
> > > [ ] -1 I am against releasing the javadoc jars (must include a reason).
> > >
> > > Vote will remain open for at least 72 hours.
> > >
> > > Note: the intention is to add the 4.0.1 Javadocs to the site at some
> > > point, but I have yet to work out how best to do that.
> > >
> > >
> > > S///
> > >
> >
>
> > ---------------------------------------------------------------------
> > 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
Re: [VOTE] Javadocs for current releases - CANCELLED
Posted by Oleg Kalnichevski <ol...@apache.org>.
On Sat, 2010-03-06 at 23:31 +0000, sebb wrote:
> Whilst preparing to release the Javadoc archives I discovered that the
> Javadocs we voted to release don't include all the modules.
>
> The httpmime and httpcore-nio modules are not included in the
> client/core Javadocs.
HttpClient does not depend on HttpCore NIO, so there is no need to
include its javadocs. Moreover, I would consider linking to the HttpCore
javadocs at the hc.apache.org as sufficient. There is no need to bundle
javadocs of dependencies.
> And although I created them as separate archives, I stupidly forgot to
> put them in the directory so they weren't part of the vote
>
> It looks like we actually need two sets of Javadocs, one for Maven
> (which is what I started creating) and another for release downloads
> which are combined Javadocs.
Do not worry about javadocs for the web site for the time being. They
can be deployed without a release vote at any point of time.
Oleg
>
> The combined Javadoc archives have different names too.
>
> Sorry for all the noise.
>
> I'll try again - hopefully better luck next time!
>
> On 01/03/2010, sebb <se...@gmail.com> wrote:
> > I've created Javadoc jars for all the current releases and uploaded them to:
> >
> > http://people.apache.org/~sebb/hc-javadoc/
> >
> > I think it would be useful to upload these to Maven and the dist
> > directory, so I guess we need to vote on them.
> >
> > Since they are only documentation, I've not bothered creating sigs for
> > them, but I can do so if it is felt necessary.
> >
> > [ ] +1 Release the Javadoc jars
> > [ ] -1 I am against releasing the javadoc jars (must include a reason).
> >
> > Vote will remain open for at least 72 hours.
> >
> > Note: the intention is to add the 4.0.1 Javadocs to the site at some
> > point, but I have yet to work out how best to do that.
> >
> >
> > S///
> >
>
> ---------------------------------------------------------------------
> 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