commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: BCEL 6 release?
Date Thu, 24 Oct 2013 02:32:36 GMT
On 24 October 2013 03:25, Gary Gregory <garydgregory@gmail.com> wrote:
> On Wed, Oct 23, 2013 at 10:12 PM, sebb <sebbaz@gmail.com> wrote:
>
>> On 23 October 2013 23:10, Gary Gregory <garydgregory@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 <russ@gold-family.us>
>> > Date:10/23/2013  17:41  (GMT-05:00)
>> > To: Commons Users List <user@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 <britter@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 <russ@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 <britter@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 <russ@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


Mime
View raw message