what to put in the distribution?

[Karl Wettin <ka...@gmail.com>]

I've looked around a bit and all projects seems to handle  
distributions differently.

For example, the Lucene java dist is split up in two, the -source dist  
and the -binary dist. And only the source dist contains the (contrib)  
dependencies. Also, the binary dist contains the demo source! Wicked.

Solr bakes it all up in one and the same file. It does contain  
dependencies.

Other projects have other ways of handling it.

I suggest we simply distribute a tar/zip-ball that contains the  
complete trunk, the core javadocs and core jar-file. And that's it.  
I.e. no examples jar nor examples javadocs.

What do you say?


       karl

Re: what to put in the distribution?

[Sean Owen <sr...@gmail.com>]

I personally have never done that -- seems simpler to just create one
.jar file with the files, rather than a .jar containing .jars. I can't
say I object though.

On Fri, Sep 19, 2008 at 2:37 PM, Karl Wettin <ka...@gmail.com> wrote:
> Perhaps a core-javadocs.jar and core-src.jar too?

Re: what to put in the distribution?

[Karl Wettin <ka...@gmail.com>]

Perhaps a core-javadocs.jar and core-src.jar too?

19 sep 2008 kl. 01.08 skrev Sean Owen:

> +1 to 1 tarball, containing source but not build products except for
> the main .jar file.
>
> On 9/18/08, Grant Ingersoll <gs...@apache.org> wrote:
>> Ah, I misread.  Just the source itself is good enough, IMO.  We can
>> change if there is a huge clamoring for it, or if someone posts a  
>> patch.
>>
>> On Sep 18, 2008, at 3:41 PM, Karl Wettin wrote:
>>
>>>
>>> 18 sep 2008 kl. 21.15 skrev Grant Ingersoll:
>>>
>>>>>
>>>>> I suggest we simply distribute a tar/zip-ball that contains the
>>>>> complete trunk, the core javadocs and core jar-file. And that's
>>>>> it. I.e. no examples jar nor examples javadocs.
>>>>
>>>> I think we'll want the examples and javadocs.  That's about the
>>>> only way people are going to be able to get started.    I think 1
>>>> tar/zip ball is good, though, that has the source, the libs and the
>>>> examples and docs.
>>>
>>> But do we really need to supply an example jar and javadocs of the
>>> example source code? Isn't the source code enough by it self?
>>>
>>>
>>>      karl
>>
>>
>>

Re: what to put in the distribution?

[Sean Owen <sr...@gmail.com>]

+1 to 1 tarball, containing source but not build products except for
the main .jar file.

On 9/18/08, Grant Ingersoll <gs...@apache.org> wrote:
> Ah, I misread.  Just the source itself is good enough, IMO.  We can
> change if there is a huge clamoring for it, or if someone posts a patch.
>
> On Sep 18, 2008, at 3:41 PM, Karl Wettin wrote:
>
>>
>> 18 sep 2008 kl. 21.15 skrev Grant Ingersoll:
>>
>>>>
>>>> I suggest we simply distribute a tar/zip-ball that contains the
>>>> complete trunk, the core javadocs and core jar-file. And that's
>>>> it. I.e. no examples jar nor examples javadocs.
>>>
>>> I think we'll want the examples and javadocs.  That's about the
>>> only way people are going to be able to get started.    I think 1
>>> tar/zip ball is good, though, that has the source, the libs and the
>>> examples and docs.
>>
>> But do we really need to supply an example jar and javadocs of the
>> example source code? Isn't the source code enough by it self?
>>
>>
>>       karl
>
>
>

Re: what to put in the distribution?

[Grant Ingersoll <gs...@apache.org>]

Ah, I misread.  Just the source itself is good enough, IMO.  We can  
change if there is a huge clamoring for it, or if someone posts a patch.

On Sep 18, 2008, at 3:41 PM, Karl Wettin wrote:

>
> 18 sep 2008 kl. 21.15 skrev Grant Ingersoll:
>
>>>
>>> I suggest we simply distribute a tar/zip-ball that contains the  
>>> complete trunk, the core javadocs and core jar-file. And that's  
>>> it. I.e. no examples jar nor examples javadocs.
>>
>> I think we'll want the examples and javadocs.  That's about the  
>> only way people are going to be able to get started.    I think 1  
>> tar/zip ball is good, though, that has the source, the libs and the  
>> examples and docs.
>
> But do we really need to supply an example jar and javadocs of the  
> example source code? Isn't the source code enough by it self?
>
>
>       karl

Re: what to put in the distribution?

[Karl Wettin <ka...@gmail.com>]

18 sep 2008 kl. 21.15 skrev Grant Ingersoll:

>>
>> I suggest we simply distribute a tar/zip-ball that contains the  
>> complete trunk, the core javadocs and core jar-file. And that's it.  
>> I.e. no examples jar nor examples javadocs.
>
> I think we'll want the examples and javadocs.  That's about the only  
> way people are going to be able to get started.    I think 1 tar/zip  
> ball is good, though, that has the source, the libs and the examples  
> and docs.

But do we really need to supply an example jar and javadocs of the  
example source code? Isn't the source code enough by it self?


        karl

Re: what to put in the distribution?

[Grant Ingersoll <gs...@apache.org>]

On Sep 18, 2008, at 2:45 PM, Karl Wettin wrote:

> I've looked around a bit and all projects seems to handle  
> distributions differently.
>
> For example, the Lucene java dist is split up in two, the -source  
> dist and the -binary dist. And only the source dist contains the  
> (contrib) dependencies. Also, the binary dist contains the demo  
> source! Wicked.
>
> Solr bakes it all up in one and the same file. It does contain  
> dependencies.
>
> Other projects have other ways of handling it.
>
> I suggest we simply distribute a tar/zip-ball that contains the  
> complete trunk, the core javadocs and core jar-file. And that's it.  
> I.e. no examples jar nor examples javadocs.

I think we'll want the examples and javadocs.  That's about the only  
way people are going to be able to get started.    I think 1 tar/zip  
ball is good, though, that has the source, the libs and the examples  
and docs.

>
>
> What do you say?
>
>
>      karl