commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [net] 2.0 Release Ready For Review
Date Tue, 23 Sep 2008 18:19:23 GMT
On 23/09/2008, Daniel F. Savarese <dfs@savarese.org> wrote:
>
>  In message <25aac9fc0809220752r444cb89dk3b2bafa6a5b389ea@mail.gmail.com>, sebb
>  writes:
>
> >On 22/09/2008, Oberhuber, Martin <Martin.Oberhuber@windriver.com> 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: dev-unsubscribe@commons.apache.org
>  For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message