From open-jpa-dev-return-2-apmail-incubator-open-jpa-dev-archive=incubator.apache.org@incubator.apache.org Thu May 04 15:43:49 2006 Return-Path: Delivered-To: apmail-incubator-open-jpa-dev-archive@locus.apache.org Received: (qmail 73209 invoked from network); 4 May 2006 15:43:48 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 4 May 2006 15:43:48 -0000 Received: (qmail 25000 invoked by uid 500); 4 May 2006 15:43:45 -0000 Delivered-To: apmail-incubator-open-jpa-dev-archive@incubator.apache.org Received: (qmail 24927 invoked by uid 500); 4 May 2006 15:43:45 -0000 Mailing-List: contact open-jpa-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: open-jpa-dev@incubator.apache.org Delivered-To: mailing list open-jpa-dev@incubator.apache.org Received: (qmail 24880 invoked by uid 99); 4 May 2006 15:43:44 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 04 May 2006 08:43:44 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests=HTML_MESSAGE,UNPARSEABLE_RELAY X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [192.18.42.249] (HELO nwkes-gis-mail-2.sun.com) (192.18.42.249) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 04 May 2006 08:43:43 -0700 Received: from d1-sfbay-02.sun.com ([192.18.39.112]) by nwkes-gis-mail-2.sun.com (8.12.9/8.12.9) with ESMTP id k44FhNgL028353 for ; Thu, 4 May 2006 08:43:23 -0700 (PDT) Received: from conversion-daemon.d1-sfbay-02.sun.com by d1-sfbay-02.sun.com (Sun Java System Messaging Server 6.2-4.02 (built Sep 9 2005)) id <0IYQ00J01ZFDQW00@d1-sfbay-02.sun.com> (original mail from Craig.Russell@Sun.COM) for open-jpa-dev@incubator.apache.org; Thu, 04 May 2006 08:43:23 -0700 (PDT) Received: from [10.192.1.180] (192-18-45-134.Sun.COM [192.18.45.134]) by d1-sfbay-02.sun.com (Sun Java System Messaging Server 6.2-4.02 (built Sep 9 2005)) with ESMTPSA id <0IYQ009BPZOA2930@d1-sfbay-02.sun.com> for open-jpa-dev@incubator.apache.org; Thu, 04 May 2006 08:43:23 -0700 (PDT) Date: Thu, 04 May 2006 08:43:16 -0700 From: Craig L Russell Subject: Repository structure Sender: Craig.Russell@Sun.COM To: open-jpa-dev@incubator.apache.org Message-id: MIME-version: 1.0 X-Mailer: Apple Mail (2.749.3) Content-type: multipart/signed; protocol="application/pkcs7-signature"; boundary=Apple-Mail-177-946475218; micalg=sha1 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N --Apple-Mail-177-946475218 Content-Type: multipart/alternative; boundary=Apple-Mail-176-946473353 --Apple-Mail-176-946473353 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Hi, Before you check in code, it would be nice to discuss the directory structure to facilitate development, release, and documentation. It would also be good to decide what build tool to use. I personally like maven for a project as complex as this one. Especially if it depends on other projects (e.g. antlr, logging, etc). After a year of work, and several iterations, the other project I'm working on has come up with this structure that we can use as a straw proposal. open-jpa/ trunk contains the main line branches contains sources for releases before release releases contains release artifacts that are then published to www.apache.org/dist site contains the sources to build the site branches/ 1.0 contains the same structure as trunk, modified for release 1.0 1.0.1 1.1... releases/ 1.0 contains one directory, dist (published exactly as is to www.apache.org/dist) site/ REAME.txt the instructions to build and publish the site build.xml the ant build script for the site xdocs the human-edited site contents docs the generated site docs/ everything that is used to display the site index.html the main page downloads.html images/ images used on the site team.html the development/test/doc team members releases/ pages for downloading releases ... other site pages trunk/ core contains the kodo core spec contains the jsr220 jar artifacts from the spec ejb contains the ejb container interface se contains the java se implementation core/ structure is repeated for each sub-project under trunk src contains the sources for the core jar test contains the test cases for the core target contains the compiler output, distribution working area, javadoc, etc. src/ java source code for the jar test/ java source code for tests xml xml configuration files for testing sql contains sql scripts for building test schema testdata contains test data files Regards, Craig Craig Russell Architect, Sun Java Enterprise System http://java.sun.com/products/jdo 408 276-5638 mailto:Craig.Russell@sun.com P.S. A good JDO? O, Gasp! --Apple-Mail-176-946473353 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=US-ASCII Hi,

Before you check in code, = it would be nice to discuss the directory structure to facilitate = development, release, and documentation.

It would also be good to = decide what build tool to use. I personally like maven for a project as = complex as this one. Especially if it depends on other projects (e.g. = antlr, logging, etc).

After a year of work, and = several iterations, the other project I'm working on has come up with = this structure that we can use as a straw proposal.

open-jpa/
trunk = contains the main line
branches contains sources for releases = before release
releases contains release artifacts that are = then published to www.apache.org/dist
site= contains the sources to build the site

branches/
1.0 = contains the same structure as trunk, modified for release = 1.0
1.0.1
1.1...

releases/
1.0 = contains one directory, dist (published exactly as is to www.apache.org/dist)
site/
REAME.txt = the instructions to build and publish the site
build.xml the = ant build script for the site
xdocs the human-edited site = contents
docs the generated site

docs/ everything that is = used to display the site
index.html the main = page
downloads.html
images/ images used on the = site
team.html the development/test/doc team = members
releases/ pages for downloading releases
... = other site pages

trunk/
core = contains the kodo core
spec contains the jsr220 jar artifacts = from the spec
ejb contains the ejb container = interface
se contains the java se implementation

core/ structure is repeated = for each sub-project under trunk
src contains the sources for = the core jar
test contains the test cases for the = core
target contains the compiler output, distribution working = area, javadoc, etc.

src/
java source = code for the jar

test/
java source = code for tests
xml xml configuration files for = testing
sql contains sql scripts for building test = schema
testdata contains test data files

Regards,

Craig

Craig Russell

Architect, Sun Java = Enterprise System http://java.sun.com/products/jdo=

408 = 276-5638 mailto:Craig.Russell@sun.com

P.S. A = good JDO? O, Gasp!


= --Apple-Mail-176-946473353-- --Apple-Mail-177-946475218 Content-Transfer-Encoding: base64 Content-Type: application/pkcs7-signature; name=smime.p7s Content-Disposition: attachment; filename=smime.p7s MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAQAAoIIGUDCCAwkw ggJyoAMCAQICEB7Y7fLHmKoeHTUdbtYrvpAwDQYJKoZIhvcNAQEEBQAwYjELMAkGA1UEBhMCWkEx JTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0ZSBQ ZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBMB4XDTA1MTIxNTIxNDc0NFoXDTA2MTIxNTIxNDc0 NFowbDEQMA4GA1UEBBMHUnVzc2VsbDEUMBIGA1UEKhMLQ3JhaWcgTGFpcmQxHDAaBgNVBAMTE0Ny YWlnIExhaXJkIFJ1c3NlbGwxJDAiBgkqhkiG9w0BCQEWFUNyYWlnLlJ1c3NlbGxAU3VuLkNPTTCC ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMXXgEAm88nu8cFbxXSWqTq+GaYpCx/0QSom 8kBbVxpJIURuO4ErLDupeXu6y9+5e7ZKLbeSQE5xbfYPcQR/IhqmYKy5YqRcuzPXREBj2zKEkZph pNXWpHgMdx9W8dq0Cu2i9Ux/S6c2MuEHrP6gfGGll+b/mzLoO280QHTuE4pcpKntRnwZdGxQ/5l8 IL+eLP+jpJAbYW9C+KNKofZtS6V6R0uzlqTOsEdZvwxZQ4mmPgHoz1+Gjwme/PC5sKvF09MaJDiI pj9SvZ4CTCgcDZV78J086YwlVbMC0VQotjhu1p42lr8CS33IXLz3OWNrDETCAepah/Dgw2ZZApQ9 9L0CAwEAAaMyMDAwIAYDVR0RBBkwF4EVQ3JhaWcuUnVzc2VsbEBTdW4uQ09NMAwGA1UdEwEB/wQC MAAwDQYJKoZIhvcNAQEEBQADgYEAKdIkgAWCg2Bi7ocnstfJA4iymTRI2/L4oQx9zvllM9bNJ2cR cecJIx3HuoHbhPvemh1GExEPgHU+dXSxDmD0BEmPnhSReKCURyslnbMphPZ5kR6USzQFrRa+v0ii J+SBO9VQYTQWT+xEjmRLM76MfkBFw3IOC9CUkRoYZ88pOoUwggM/MIICqKADAgECAgENMA0GCSqG SIb3DQEBBQUAMIHRMQswCQYDVQQGEwJaQTEVMBMGA1UECBMMV2VzdGVybiBDYXBlMRIwEAYDVQQH EwlDYXBlIFRvd24xGjAYBgNVBAoTEVRoYXd0ZSBDb25zdWx0aW5nMSgwJgYDVQQLEx9DZXJ0aWZp Y2F0aW9uIFNlcnZpY2VzIERpdmlzaW9uMSQwIgYDVQQDExtUaGF3dGUgUGVyc29uYWwgRnJlZW1h aWwgQ0ExKzApBgkqhkiG9w0BCQEWHHBlcnNvbmFsLWZyZWVtYWlsQHRoYXd0ZS5jb20wHhcNMDMw NzE3MDAwMDAwWhcNMTMwNzE2MjM1OTU5WjBiMQswCQYDVQQGEwJaQTElMCMGA1UEChMcVGhhd3Rl IENvbnN1bHRpbmcgKFB0eSkgTHRkLjEsMCoGA1UEAxMjVGhhd3RlIFBlcnNvbmFsIEZyZWVtYWls IElzc3VpbmcgQ0EwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMSmPFVzVftOucqZWh5owHUE cJ3f6f+jHuy9zfVb8hp2vX8MOmHyv1HOAdTlUAow1wJjWiyJFXCO3cnwK4Vaqj9xVsuvPAsH5/Ef kTYkKhPPK9Xzgnc9A74r/rsYPge/QIACZNenprufZdHFKlSFD0gEf6e20TxhBEAeZBlyYLf7AgMB AAGjgZQwgZEwEgYDVR0TAQH/BAgwBgEB/wIBADBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3Js LnRoYXd0ZS5jb20vVGhhd3RlUGVyc29uYWxGcmVlbWFpbENBLmNybDALBgNVHQ8EBAMCAQYwKQYD VR0RBCIwIKQeMBwxGjAYBgNVBAMTEVByaXZhdGVMYWJlbDItMTM4MA0GCSqGSIb3DQEBBQUAA4GB AEiM0VCD6gsuzA2jZqxnD3+vrL7CF6FDlpSdf0whuPg2H6otnzYvwPQcUCCTcDz9reFhYsPZOhl+ hLGZGwDFGguCdJ4lUJRix9sncVcljd2pnDmOjCBPZV+V2vf3h9bGCE6u9uo05RAaWzVNd+NWIXiC 3CEZNd4ksdMdRv9dX2VPMYIDEDCCAwwCAQEwdjBiMQswCQYDVQQGEwJaQTElMCMGA1UEChMcVGhh d3RlIENvbnN1bHRpbmcgKFB0eSkgTHRkLjEsMCoGA1UEAxMjVGhhd3RlIFBlcnNvbmFsIEZyZWVt YWlsIElzc3VpbmcgQ0ECEB7Y7fLHmKoeHTUdbtYrvpAwCQYFKw4DAhoFAKCCAW8wGAYJKoZIhvcN AQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMDYwNTA0MTU0MzE4WjAjBgkqhkiG9w0B CQQxFgQUF1mjew3YKpXcpxIS2AW9PAkBw8AwgYUGCSsGAQQBgjcQBDF4MHYwYjELMAkGA1UEBhMC WkExJTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0 ZSBQZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBAhAe2O3yx5iqHh01HW7WK76QMIGHBgsqhkiG 9w0BCRACCzF4oHYwYjELMAkGA1UEBhMCWkExJTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQ dHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBAhAe 2O3yx5iqHh01HW7WK76QMA0GCSqGSIb3DQEBAQUABIIBADvzlf4ryJRc0gdABbsjWDXL7Nm+Cxrf /8fVlqM5ld79BQ47Y5ptohO5A1oyww+FIc8unWHJ0zLOLUR7PiHKv+zB8uBRpWfhg+3FaTyWojDp z4dTowCV/g2kmzrHQ+CNW3N4Pp2/XPg4mTXU1hcctzcpf+jQzT/Ittejj1Y6/kClve1r4bpVQU7B fj353dJ3ej589Zmmpn5RQiai8RxVPrduq/Ufq0lvomgcCIDivSSZ8LwPA2D1qU8z2zkrxYxJ7cMf aj56ofLrJzaQG2A2slChzz3gi726GmQG1UZTSq1J1EWt3M46di1RMk8wFB15L0t2BRdZAG4n4BId rSGrTagAAAAAAAA= --Apple-Mail-177-946475218--