On 14 March 2012 16:27, Honton, Charles <charles_hon...@intuit.com> wrote: > As a user of commons libraries, I look at several reports. I'll consult > Javadoc first. In the case the javadoc is silent about behavior, I look at > JXR.
+1, JXR has been very useful to me. > When I am debugging my code's interaction with the commons library, I want to > have the sources available to my IDE, so that I can step through the commons > library. > chas > > -----Original Message----- > From: Gilles Sadowski [mailto:gil...@harfang.homelinux.org] > Sent: Wednesday, March 14, 2012 1:51 AM > To: dev@commons.apache.org > Subject: Re: [ALL] Commons Parent reports > > On Tue, Mar 13, 2012 at 01:52:32PM -0400, Gary Gregory wrote: >> On Mar 13, 2012, at 12:40, Gilles Sadowski <gil...@harfang.homelinux.org> >> wrote: >> >> >>> >> >>>>> [...] >> >>>>> >> >>>>> The tools are there, but you have to tell people that they _must_ use >> >>>>> them. >> >>>> >> >>>> Commons has already enough rules and process. As long as the releases >> >>>> are have clean code I wouldn't be too anal about the commits in >> >>>> between. >> >>> >> >>> I think that the main disagreement is here. Source code must be a clear >> >>> read >> >>> for the _developers_. To put it bluntly, I don't care that the releases >> >>> have >> >>> cleanly formatted code, as almost nobody is going to read those packaged >> >>> sources! >> >> Au contraire, most users will /only/ look at the source jar because >> that is what you use in the debugger! > > Here IMHO you are talking about _developers_. > By users I meant people who include the classes JAR in their classpath. > They will at most look at the API docs. > > > Gilles > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
