On 24 October 2013 03:25, Gary Gregory <garydgreg...@gmail.com> wrote: > On Wed, Oct 23, 2013 at 10:12 PM, sebb <seb...@gmail.com> wrote: > >> On 23 October 2013 23:10, Gary Gregory <garydgreg...@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 <r...@gold-family.us> >> > Date:10/23/2013 17:41 (GMT-05:00) >> > To: Commons Users List <u...@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 <brit...@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 <r...@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 <brit...@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 <r...@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-unsubscr...@commons.apache.org >> For additional commands, e-mail: dev-h...@commons.apache.org >> >> > > > -- > E-Mail: garydgreg...@gmail.com | ggreg...@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-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
