On 22/09/2008, Oberhuber, Martin <[EMAIL PROTECTED]> wrote: > > Also, the binary jar contains an examples/ directory, but it contains > > only the class files. > > > > Surely it should contain the source files instead? > > > I'm not sure about best practices used in Apache Commons, but > it seems odd to me that examples code is even found in the > binary jar.
I suppose the idea is that it shows you how to use the code - which of course requires the source, not the class files. I think some binary jars also have the Javadoc. > Shouldn't the binary jar be ready for deployment into client > applications? Doesn't seem like source code or an examples/ > package is right in something to be deployed. If example source and Javadoc are included that only increases the jar size - perhaps not ideal. But having example classes is potentially a problem, especially if they aren't in the expected package. > I'd rather put the examples into a separate Jar of their own, > but again I'm not sure what other Commons projects do? > That would be better - and/or on the web-site. They should be in the source jar as well. > Cheers, > -- > Martin Oberhuber, Senior Member of Technical Staff, Wind River > Target Management Project Lead, DSDP PMC Member > http://www.eclipse.org/dsdp/tm > > > > > -----Original Message----- > > > From: sebb [mailto:[EMAIL PROTECTED] > > Sent: Thursday, September 18, 2008 4:05 PM > > To: Commons Developers List > > Subject: Re: [net] 2.0 Release Ready For Review > > > > Also, the binary jar contains an examples/ directory, but it contains > > only the class files. > > > > Surely it should contain the source files instead? > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
