On 23/09/2008, Daniel F. Savarese <[EMAIL PROTECTED]> wrote: > > In message <[EMAIL PROTECTED]>, sebb > writes: > > >On 22/09/2008, Oberhuber, Martin <[EMAIL PROTECTED]> wrote: > > >> 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. > > > I don't think the examples should be pre-compiled at all. They are > source code examples that demonstrate how to use the API.
That's what I was intending to say, and I think that was Martin's point as well... > Unless something has changed recently, they are not intended as fully > functional programs for actual use, which pre-compiling would > encourage. Instead, they are a starting point for developers new to > the library to experiment, starting by compiling the examples for > themselves. In effect, the examples serve as supplementary > documentation and should be treated the same as documentation. Agreed. As mentioned previously, I think I've seen some Apache binary jars which include Javadoc and source examples. > At > least, that was the original intent, which may have been lost after > Mavenization. > > > daniel > > > > > --------------------------------------------------------------------- > 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]
