release folder structure

3 messages Options
Embed this post
Permalink
Aristedes Maniatis-2

release folder structure

Reply Threaded More More options
Print post
Permalink
In the OSX dmg I can see several files I don't understand.

cayenne-agent.jar
cayenne-tools.jar
cayenne-modeler.jar

Well, I do understand the last one, but I don't know why it is there since we already ship CayenneModeler.app.


Also, why do we have META-INF inside the src directory?  Let's get rid of it.

I'd like to see the 'dotemplates' folder renamed to "entity templates" (hey this is 2009 we are allowed to use spaces) and placed at the top level.

Finally, let's remove the cayenne-3.0B1 folder. So the results would be like this:


cayenne.dmg
  - CayenneModeler.app
  - lib
    - cayenne-client-3.0.jar
    - cayenne-server-3.0.jar
    - third-party
  - src
    - org
  - entity templates
  - doc
    - README.txt
    - LICENSE.txt
    - RELEASE-NOTES.txt
    - NOTICE.txt
    - UPGRADE.txt
    - KEYS
    - documentation
    - schema
    - javaDoc
      - api
      - images
      - style.css
      - index.html



I'd make some changes to these myself, but every attempt I have had at changing maven config hasn't resulted in happiness...

I think this makes the content more obvious and more accessible to new users.

Ari

--

-------------------------->
Aristedes Maniatis
GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A
Andrus Adamchik

Re: release folder structure

Reply Threaded More More options
Print post
Permalink

On Oct 29, 2009, at 11:11 AM, Aristedes Maniatis wrote:

> In the OSX dmg I can see several files I don't understand.
>
> cayenne-agent.jar

This was for class enhancement. Since the POJOs are not really working  
in 3.0, we can remove it from the future betas.

> cayenne-tools.jar

Ant tasks. We don't want them in the main Jar, because they have lots  
of specific dependencies that we don't want to be attached by Maven to  
the user apps.


> cayenne-modeler.jar
>
> Well, I do understand the last one, but I don't know why it is there  
> since we already ship CayenneModeler.app.

This is a CayenneModeler "library" used for JNDI hack:

http://cayenne.apache.org/doc/local-datasources.html

I hope we can strip the read-JNDI-from-preferences code out of the  
modeler, but this is pending a decision on Modeler preferences format  
in general.


> Also, why do we have META-INF inside the src directory?  Let's get  
> rid of it.

+1.

>
> I'd like to see the 'dotemplates' folder renamed to "entity  
> templates" (hey this is 2009 we are allowed to use spaces) and  
> placed at the top level.

We are, but we'll probably get punished for it in some unforeseen  
ways :-) We can just call it "templates" going forward.


> Finally, let's remove the cayenne-3.0B1 folder. So the results would  
> be like this:
>
>
> cayenne.dmg
> - CayenneModeler.app
> - lib
>   - cayenne-client-3.0.jar
...

I sort of like that I can mount a DMG, then drag the Modeler to  
desktop, and drag cayenne-3.0B1 to the folder where I keep other  
similar libraries. Looks very intuitive to me.

Andrus


Michael Gentry-2

Re: release folder structure

Reply Threaded More More options
Print post
Permalink
On Thu, Oct 29, 2009 at 9:04 AM, Andrus Adamchik <[hidden email]> wrote:

>
> On Oct 29, 2009, at 11:11 AM, Aristedes Maniatis wrote:
>> Finally, let's remove the cayenne-3.0B1 folder. So the results would be
>> like this:
>>
>>
>> cayenne.dmg
>> - CayenneModeler.app
>> - lib
>>  - cayenne-client-3.0.jar
>
> ...
>
> I sort of like that I can mount a DMG, then drag the Modeler to desktop, and
> drag cayenne-3.0B1 to the folder where I keep other similar libraries. Looks
> very intuitive to me.
>
> Andrus


That's exactly what I do ... except I drag the modeler to ~/Applications.

mrg