You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sebb <se...@gmail.com> on 2013/10/24 04:12:26 UTC
Re: BCEL 6 release?
On 23 October 2013 23:10, Gary Gregory <ga...@gmail.com> wrote:
> I wish we could just keep each version on the site...
We can; several components have multiple Javadoc directories.
Also there is no reason why the website should not reflect the
released version, rather than current trunk.
>From the point of view of an end-user, it's pretty useless if the site
documentation corresponds to a version that does not exist as a
downloadable release.
>
> Sent via the Samsung Galaxy Note® 3, an AT&T 4G LTE smartphone
>
> -------- Original message --------
> From: Russell Gold <ru...@gold-family.us>
> Date:10/23/2013 17:41 (GMT-05:00)
> To: Commons Users List <us...@commons.apache.org>
> Subject: Re: BCEL 6 release?
>
> Hi Benedikt,
>
> Yes, that is what I would have expected. Since BCEL 5.2 is the latest version available at Maven Central, wouldn't it make sense to check out that release tag and update the web site from that? The api has changed enough between 5.2 and 6.0-SNAPSHOT that the latter is not all that useful.
>
> Thanks,
> Russ
>
> On Oct 23, 2013, at 3:51 PM, Benedikt Ritter <br...@apache.org> wrote:
>
>> Hello Russell,
>>
>> no the whole site of on component is published at once. I cannot decide to
>> just publish the JavaDoc for example. If I want to go back to the JavaDoc
>> of BCEL 5.1 I would have to checkout the release tag and publish that. Hope
>> that makes sense :-)
>>
>> Benedikt
>>
>>
>> 2013/10/23 Russell Gold <ru...@gold-family.us>
>>
>>> Hi Benedikt,
>>>
>>> So the apache commons site is published as a whole? It's not done on a
>>> project by project basis? Or by "the whole site" do you mean specifically
>>> the BCEL site? And people are updating other parts of it manually?
>>>
>>> Thanks,
>>> Russ
>>>
>>> On Oct 23, 2013, at 2:23 PM, Benedikt Ritter <br...@apache.org> wrote:
>>>
>>>> Hello Russell,
>>>>
>>>> there is currently very low activity in BCEL. The reason that the API
>>>> documentation refers to the SNAPSHOT is, that we don't maintain the
>>> website
>>>> by hand. It is generated and deployed by maven. So if anybody decides to
>>>> update other parts of the website (like the user guide for example) he
>>> has
>>>> to re publish the complete website (build from trunk). This is also the
>>>> reason I can't simply checkout the release tag and publish the site from
>>>> there. It would override changes that have been made in the meantime.
>>>>
>>>> Usually we publish sources and JavaDoc jars to maven central. But for
>>> BCEL
>>>> 5.1 [1] is looks like there is only a sources jar. The only possibility I
>>>> currently see for you is to download the sources jar or checkout the
>>>> release tag and run mvn site.
>>>>
>>>> Benedikt
>>>>
>>>> [1] http://search.maven.org/#artifactdetails%7Cbcel%7Cbcel%7C5.1%7Cjar
>>>>
>>>>
>>>> 2013/10/23 Russell Gold <ru...@gold-family.us>
>>>>
>>>>> Hi,
>>>>>
>>>>> I notice that the javadoc on the website for BCEL <
>>>>> http://commons.apache.org/proper/commons-bcel/apidocs/index.html>
>>> refers
>>>>> to version 6.0-SNAPSHOT. But that snapshot version is, naturally, not
>>>>> available on maven central? Is the project dead? If not, could it
>>> either be
>>>>> released or the site updated to show the current released version?
>>>>>
>>>>> Thanks,
>>>>> Russ Gold
>>>>> -----------------
>>>>> Author, Getting Started with Apache Maven <
>>>>> http://www.packtpub.com/getting-started-with-apache-maven/video>
>>>>>
>>>>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
>>>>> and listen to the Misfile radio play <
>>>>> http://www.fuzzyfacetheater.com/misfile/>!
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> http://people.apache.org/~britter/
>>>> http://www.systemoutprintln.de/
>>>> http://twitter.com/BenediktRitter
>>>> http://github.com/britter
>>>
>>> -----------------
>>> Author, Getting Started with Apache Maven <
>>> http://www.packtpub.com/getting-started-with-apache-maven/video>
>>>
>>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
>>> and listen to the Misfile radio play <
>>> http://www.fuzzyfacetheater.com/misfile/>!
>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>
>>
>> --
>> http://people.apache.org/~britter/
>> http://www.systemoutprintln.de/
>> http://twitter.com/BenediktRitter
>> http://github.com/britter
>
> -----------------
> Author, Getting Started with Apache Maven <http://www.packtpub.com/getting-started-with-apache-maven/video>
>
> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
> and listen to the Misfile radio play <http://www.fuzzyfacetheater.com/misfile/>!
>
>
>
>
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: BCEL 6 release?
Posted by sebb <se...@gmail.com>.
On 24 October 2013 03:25, Gary Gregory <ga...@gmail.com> wrote:
> On Wed, Oct 23, 2013 at 10:12 PM, sebb <se...@gmail.com> wrote:
>
>> On 23 October 2013 23:10, Gary Gregory <ga...@gmail.com> wrote:
>> > I wish we could just keep each version on the site...
>>
>> We can; several components have multiple Javadoc directories.
>>
>> Also there is no reason why the website should not reflect the
>> released version, rather than current trunk.
>>
>
> Yeah, sure, some components do that, which is nice. I'm talking about the
> whole site for a given version. This allows you to see the whole kit for
> whatever version you're dealing with, docs, Javadocs, reports and all.
I see no reason why that would not also be possible, using the same
technique as for the Javadocs.
However, I question whether it is worth it in most cases.
Provided that the @since markers and change history are accurate, it
seems like a lot of work for not much gain.
> Gary
>
>>
>> From the point of view of an end-user, it's pretty useless if the site
>> documentation corresponds to a version that does not exist as a
>> downloadable release.
>>
>> >
>> > Sent via the Samsung Galaxy Note® 3, an AT&T 4G LTE smartphone
>> >
>> > -------- Original message --------
>> > From: Russell Gold <ru...@gold-family.us>
>> > Date:10/23/2013 17:41 (GMT-05:00)
>> > To: Commons Users List <us...@commons.apache.org>
>> > Subject: Re: BCEL 6 release?
>> >
>> > Hi Benedikt,
>> >
>> > Yes, that is what I would have expected. Since BCEL 5.2 is the latest
>> version available at Maven Central, wouldn't it make sense to check out
>> that release tag and update the web site from that? The api has changed
>> enough between 5.2 and 6.0-SNAPSHOT that the latter is not all that useful.
>> >
>> > Thanks,
>> > Russ
>> >
>> > On Oct 23, 2013, at 3:51 PM, Benedikt Ritter <br...@apache.org> wrote:
>> >
>> >> Hello Russell,
>> >>
>> >> no the whole site of on component is published at once. I cannot decide
>> to
>> >> just publish the JavaDoc for example. If I want to go back to the
>> JavaDoc
>> >> of BCEL 5.1 I would have to checkout the release tag and publish that.
>> Hope
>> >> that makes sense :-)
>> >>
>> >> Benedikt
>> >>
>> >>
>> >> 2013/10/23 Russell Gold <ru...@gold-family.us>
>> >>
>> >>> Hi Benedikt,
>> >>>
>> >>> So the apache commons site is published as a whole? It's not done on a
>> >>> project by project basis? Or by "the whole site" do you mean
>> specifically
>> >>> the BCEL site? And people are updating other parts of it manually?
>> >>>
>> >>> Thanks,
>> >>> Russ
>> >>>
>> >>> On Oct 23, 2013, at 2:23 PM, Benedikt Ritter <br...@apache.org>
>> wrote:
>> >>>
>> >>>> Hello Russell,
>> >>>>
>> >>>> there is currently very low activity in BCEL. The reason that the API
>> >>>> documentation refers to the SNAPSHOT is, that we don't maintain the
>> >>> website
>> >>>> by hand. It is generated and deployed by maven. So if anybody decides
>> to
>> >>>> update other parts of the website (like the user guide for example) he
>> >>> has
>> >>>> to re publish the complete website (build from trunk). This is also
>> the
>> >>>> reason I can't simply checkout the release tag and publish the site
>> from
>> >>>> there. It would override changes that have been made in the meantime.
>> >>>>
>> >>>> Usually we publish sources and JavaDoc jars to maven central. But for
>> >>> BCEL
>> >>>> 5.1 [1] is looks like there is only a sources jar. The only
>> possibility I
>> >>>> currently see for you is to download the sources jar or checkout the
>> >>>> release tag and run mvn site.
>> >>>>
>> >>>> Benedikt
>> >>>>
>> >>>> [1]
>> http://search.maven.org/#artifactdetails%7Cbcel%7Cbcel%7C5.1%7Cjar
>> >>>>
>> >>>>
>> >>>> 2013/10/23 Russell Gold <ru...@gold-family.us>
>> >>>>
>> >>>>> Hi,
>> >>>>>
>> >>>>> I notice that the javadoc on the website for BCEL <
>> >>>>> http://commons.apache.org/proper/commons-bcel/apidocs/index.html>
>> >>> refers
>> >>>>> to version 6.0-SNAPSHOT. But that snapshot version is, naturally, not
>> >>>>> available on maven central? Is the project dead? If not, could it
>> >>> either be
>> >>>>> released or the site updated to show the current released version?
>> >>>>>
>> >>>>> Thanks,
>> >>>>> Russ Gold
>> >>>>> -----------------
>> >>>>> Author, Getting Started with Apache Maven <
>> >>>>> http://www.packtpub.com/getting-started-with-apache-maven/video>
>> >>>>>
>> >>>>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
>> >>>>> and listen to the Misfile radio play <
>> >>>>> http://www.fuzzyfacetheater.com/misfile/>!
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>
>> >>>>
>> >>>> --
>> >>>> http://people.apache.org/~britter/
>> >>>> http://www.systemoutprintln.de/
>> >>>> http://twitter.com/BenediktRitter
>> >>>> http://github.com/britter
>> >>>
>> >>> -----------------
>> >>> Author, Getting Started with Apache Maven <
>> >>> http://www.packtpub.com/getting-started-with-apache-maven/video>
>> >>>
>> >>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
>> >>> and listen to the Misfile radio play <
>> >>> http://www.fuzzyfacetheater.com/misfile/>!
>> >>>
>> >>>
>> >>>
>> >>>
>> >>>
>> >>>
>> >>>
>> >>>
>> >>
>> >>
>> >> --
>> >> http://people.apache.org/~britter/
>> >> http://www.systemoutprintln.de/
>> >> http://twitter.com/BenediktRitter
>> >> http://github.com/britter
>> >
>> > -----------------
>> > Author, Getting Started with Apache Maven <
>> http://www.packtpub.com/getting-started-with-apache-maven/video>
>> >
>> > Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
>> > and listen to the Misfile radio play <
>> http://www.fuzzyfacetheater.com/misfile/>!
>> >
>> >
>> >
>> >
>> >
>> >
>> >
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: BCEL 6 release?
Posted by Gary Gregory <ga...@gmail.com>.
On Wed, Oct 23, 2013 at 10:12 PM, sebb <se...@gmail.com> wrote:
> On 23 October 2013 23:10, Gary Gregory <ga...@gmail.com> wrote:
> > I wish we could just keep each version on the site...
>
> We can; several components have multiple Javadoc directories.
>
> Also there is no reason why the website should not reflect the
> released version, rather than current trunk.
>
Yeah, sure, some components do that, which is nice. I'm talking about the
whole site for a given version. This allows you to see the whole kit for
whatever version you're dealing with, docs, Javadocs, reports and all.
Gary
>
> From the point of view of an end-user, it's pretty useless if the site
> documentation corresponds to a version that does not exist as a
> downloadable release.
>
> >
> > Sent via the Samsung Galaxy Note® 3, an AT&T 4G LTE smartphone
> >
> > -------- Original message --------
> > From: Russell Gold <ru...@gold-family.us>
> > Date:10/23/2013 17:41 (GMT-05:00)
> > To: Commons Users List <us...@commons.apache.org>
> > Subject: Re: BCEL 6 release?
> >
> > Hi Benedikt,
> >
> > Yes, that is what I would have expected. Since BCEL 5.2 is the latest
> version available at Maven Central, wouldn't it make sense to check out
> that release tag and update the web site from that? The api has changed
> enough between 5.2 and 6.0-SNAPSHOT that the latter is not all that useful.
> >
> > Thanks,
> > Russ
> >
> > On Oct 23, 2013, at 3:51 PM, Benedikt Ritter <br...@apache.org> wrote:
> >
> >> Hello Russell,
> >>
> >> no the whole site of on component is published at once. I cannot decide
> to
> >> just publish the JavaDoc for example. If I want to go back to the
> JavaDoc
> >> of BCEL 5.1 I would have to checkout the release tag and publish that.
> Hope
> >> that makes sense :-)
> >>
> >> Benedikt
> >>
> >>
> >> 2013/10/23 Russell Gold <ru...@gold-family.us>
> >>
> >>> Hi Benedikt,
> >>>
> >>> So the apache commons site is published as a whole? It's not done on a
> >>> project by project basis? Or by "the whole site" do you mean
> specifically
> >>> the BCEL site? And people are updating other parts of it manually?
> >>>
> >>> Thanks,
> >>> Russ
> >>>
> >>> On Oct 23, 2013, at 2:23 PM, Benedikt Ritter <br...@apache.org>
> wrote:
> >>>
> >>>> Hello Russell,
> >>>>
> >>>> there is currently very low activity in BCEL. The reason that the API
> >>>> documentation refers to the SNAPSHOT is, that we don't maintain the
> >>> website
> >>>> by hand. It is generated and deployed by maven. So if anybody decides
> to
> >>>> update other parts of the website (like the user guide for example) he
> >>> has
> >>>> to re publish the complete website (build from trunk). This is also
> the
> >>>> reason I can't simply checkout the release tag and publish the site
> from
> >>>> there. It would override changes that have been made in the meantime.
> >>>>
> >>>> Usually we publish sources and JavaDoc jars to maven central. But for
> >>> BCEL
> >>>> 5.1 [1] is looks like there is only a sources jar. The only
> possibility I
> >>>> currently see for you is to download the sources jar or checkout the
> >>>> release tag and run mvn site.
> >>>>
> >>>> Benedikt
> >>>>
> >>>> [1]
> http://search.maven.org/#artifactdetails%7Cbcel%7Cbcel%7C5.1%7Cjar
> >>>>
> >>>>
> >>>> 2013/10/23 Russell Gold <ru...@gold-family.us>
> >>>>
> >>>>> Hi,
> >>>>>
> >>>>> I notice that the javadoc on the website for BCEL <
> >>>>> http://commons.apache.org/proper/commons-bcel/apidocs/index.html>
> >>> refers
> >>>>> to version 6.0-SNAPSHOT. But that snapshot version is, naturally, not
> >>>>> available on maven central? Is the project dead? If not, could it
> >>> either be
> >>>>> released or the site updated to show the current released version?
> >>>>>
> >>>>> Thanks,
> >>>>> Russ Gold
> >>>>> -----------------
> >>>>> Author, Getting Started with Apache Maven <
> >>>>> http://www.packtpub.com/getting-started-with-apache-maven/video>
> >>>>>
> >>>>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
> >>>>> and listen to the Misfile radio play <
> >>>>> http://www.fuzzyfacetheater.com/misfile/>!
> >>>>>
> >>>>>
> >>>>>
> >>>>>
> >>>>>
> >>>>>
> >>>>>
> >>>>>
> >>>>
> >>>>
> >>>> --
> >>>> http://people.apache.org/~britter/
> >>>> http://www.systemoutprintln.de/
> >>>> http://twitter.com/BenediktRitter
> >>>> http://github.com/britter
> >>>
> >>> -----------------
> >>> Author, Getting Started with Apache Maven <
> >>> http://www.packtpub.com/getting-started-with-apache-maven/video>
> >>>
> >>> Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
> >>> and listen to the Misfile radio play <
> >>> http://www.fuzzyfacetheater.com/misfile/>!
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>
> >>
> >> --
> >> http://people.apache.org/~britter/
> >> http://www.systemoutprintln.de/
> >> http://twitter.com/BenediktRitter
> >> http://github.com/britter
> >
> > -----------------
> > Author, Getting Started with Apache Maven <
> http://www.packtpub.com/getting-started-with-apache-maven/video>
> >
> > Come read my webnovel, Take a Lemon <http://www.takealemon.com>,
> > and listen to the Misfile radio play <
> http://www.fuzzyfacetheater.com/misfile/>!
> >
> >
> >
> >
> >
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
--
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory