Added: db/torque/site-scmpublish/torque-3.3/developer-info/subversion.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/developer-info/subversion.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/developer-info/subversion.html (added) +++ db/torque/site-scmpublish/torque-3.3/developer-info/subversion.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,174 @@ +Subversion - Torque

Torque Source code management

+

+ Up to release 3.1.1, Torque used CVS as its source code + repository. Most of the older releases still point to the CVS + repository at cvs.apache.org. During the 3.2 development cycle, + the Torque team (with a few well-meant nudges from the Apache + Software Foundation infrastructure team) decided to move the + Torque source code from CVS to Subversion. +

+ +

+ If you have never worked with Subversion before, please take a + look at the free + subversion book and also at Source + code repositories at the Apache Software Foundation to get + more information. +

+

The Torque repository

+

+ Unlike some other repositories you might know, Torque makes some + use of the svn:externals + feature of Subversion to organize its tree. This might lead to + some "gotchas", so be warned. +

+ +

Torque Repository Structure

+ +

+ Here is what the Torque directory structure looks like in SVN: +

+ + +
+    db/torque/
+      common           <--- contains files common to all components.
+                            Referenced by svn:externals
+      runtime          <--- contains the runtime component
+      generator        <--- contains the generator component
+      templates        <--- contains the generator templates component
+      maven-plugin     <--- contains the maven plugin component
+      maven2-plugin    <--- contains the maven 2 plugin component
+      test             <--- contains the test component
+      trunks           <--- contains references to the trunks of all 
+                            component (via svn:externals)
+      site             <--- contains the "frame" of the sources of the
+                            homepage (everything not related to a specific 
+                            component)
+      branches         <--- old branches (pre-3.2)
+      tags             <--- old tags (pre-3.2)
+      
+ +
+ + + +

Runtime, Generator, Templates, Maven 1 Plugin, Maven 2 Plugin

+

+ These modules make up the main torque distribution. They + are released in regular intervals and are available as binary + and source distributions from the + Torque download page. Each of these modules is developed + on its own Subversion trunk; Tags and Branches are located in + the respective .../tags and .../branches + subdirectories. +

+
+ +

Common

+

+ The common module is a special module because it contains files + that are needed in all main modules of the Torque source + tree. Every module pulls it into its source tree through an + external reference and references the files in the common module + as /common/...

+ Please be aware that every change + inside this module influences the build process of all the + Torque modules!. +

+
+

Test project

+

+ The test project is used by Torque developers to test the functionality + of Torque. See the test guide + for an explanation of how to run the tests. +

+
+

Site

+

+ The Torque site contains the information global to all Torque + releases such as main navigation, download page or the page + you're currently reading. +

+
+

Old CVS tags and branches

+

+ All CVS tags and branches that existed before the conversion to Subversion have + been preserved. These are only for historic reasons and there will be no more + development here. Branches and Tags after the Subversion conversion will be located + in the module specific branches/ and tags/ directories. + +

    +
  • + Old CVS Tags + -- http://svn.apache.org/repos/asf/db/torque/tags/ +
  • +
  • + Old CVS Branches + -- http://svn.apache.org/repos/asf/db/torque/branches/ +
  • +
+

+

The trunks module

+

+ The Torque subversion repository contains another module for + development called trunks. While + this module seems quite empty, it is not.

+ If you want to work on the Torque code base, your best guess will be to + check out this module using + + +

svn checkout http://svn.apache.org/repos/asf/db/torque/trunks torque
+ + + The resulting directory will contain the trunk locations of all + main Torque parts. This also happens through svn:external + references. +

+

Multi-Project build

+

+ The trunks module also contains a Multi-Project + build environment to build all the major parts of Torque in one + go.

+ If you checked out the trunks module from subversion, you can run one of + the following goals inside the resulting directory: + +

    +
  • + build -- Builds all parts of Torque +
  • +
  • + install - Builds all parts of Torque and installs the resulting jars + and plugins into your local maven repository +
  • +
  • + site -- Builds the documentation sites for all parts of Torque +
  • +
+

+

\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/developer-info/test-project.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/developer-info/test-project.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/developer-info/test-project.html (added) +++ db/torque/site-scmpublish/torque-3.3/developer-info/test-project.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,130 @@ +Test project - Torque

The Torque test project

+

+ The test project tests all aspects of the Torque main distribution + and checks whether the different parts of Torque (runtime, generator, + templates, maven-plugin) work together. The test project is almost + a normal Torque project, with the following differences: +

    +
  • + It contains additional maven goals to run the tests +
  • +
  • + Instead of directly using the schema files from the + src/schema directory, the schema files are copied to the + directory target/schema, and some tokens are replaced during + copying. + For the tests, the schema files from target/schema with the + replaced tokens are used. +
  • +
  • + The test project POM extends the POM of one of the test profiles + (which in turn extend the POM of the Torque runtime in order to + include all dependencies of the runtime). To choose the parent POM + out of the many profiles, the maven parameter + torque.test.profile must be set to the name of the + directory containing the chosen profile (see below for instructions + and an example). +
  • +
+

+ +

Running the test project using Maven 1

+

+ In order to run the test project, the following procedure is + recommended: +

    +
  • + Check out the trunks module from the svn repository +
  • +
  • + Change into the directory trunks/test/profile, and change + one of the profiles to match the database which you want to test + against. The file project.xml contains the location of + the jdbc driver (you might need to install the driver manually + to the local maven repository, see the Tutorial on how to do + this). The file project.properties contains the + settings for the maven plugin (and thus the generator), + and the file Torque.properties contains the settings for + the runtime. +
  • +
  • + Change into the directory trunks/test/test-project, + and run the command + maven -Dtorque.test.profile=${profile} + to run the test, replacing the variable + ${profile} with the name of your chosen profile + directory. For example, if you want to test against mysql, run + maven -Dtorque.test.profile=mysql +

    + If you want to build all Torque modules from source, install them + in your local maven repository, and run the test using the newly + installed Torque components all in one rush, use the command + maven -Dtorque.test.profile=${profile} torque-test:install-run +
  • +
+

+
+ +

Common pitfalls when using Maven 1

+

+ If maven complains about not being able to load its parent POM, + this is probably due to one of the following: +

    +
  • + The maven parameter torque.test.profile + is either not set or set to the wrong value. Set it to a valid + value, for example by using the command line parameter + -Dtorque.test.profile=mysql when running maven. +
  • +
  • + You have not checked out the whole trunks module. The test project + indirectly extends the runtime POM (via the profile POMs) to + include the libary the runtime depends on. Either check out the + whole trunks directory, or get the runtime POM from somewhere else + and refer to it in the <extend> part of the + profile. +
  • +
+

+
+ +

Running the test project using Maven 2

+

+ In order to run the test project with maven 2, use the following + procedure: +

    +
  • + Check out the trunks module from the svn repository. +
  • +
  • + Change into the each of the directories runtime, + templates, generator and maven2-plugin + and run the command mvn install + in each of the directories (in the order above). +
  • +
  • + Change into the directory trunks/test/test-project, + and change one of the profiles in the file profiles.xml + to match the database which you want to test against. +
  • +
  • + In the directory trunks/test/test-project, + run the command mvn -P${profile} test + to run the test, replacing the variable + ${profile} with the name of your chosen profile. + For example, if you want to test against mysql, run + mvn -Pmysql test +
  • +
+

+
+ +

\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/documentation/index.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/documentation/index.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/documentation/index.html (added) +++ db/torque/site-scmpublish/torque-3.3/documentation/index.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,32 @@ +Documentation for Torque - Torque

Documentation for Torque

+ +

+ This contains the documentation for Torque. + The documentation is separated into the different components of Torque + and the different releases of Torque. +

+ - To get information about generating the java classes using Maven, + see the Maven plugin documentation. +

+ - To learn about generating the java classes using Ant, + see the generator documentation. +

+ - The reference for using the generated classes in your project can + be found in the runtime documentation. +

+ - Information about peculiarities of some databases can be found in the + Database Howtos. +

+ - General howtos spanning several of Torque's components + ara available in the "other Howtos". +

+ +

\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/documentation/torque-3.3.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/documentation/torque-3.3.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/documentation/torque-3.3.html (added) +++ db/torque/site-scmpublish/torque-3.3/documentation/torque-3.3.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,33 @@ +Documentation for Torque 3.3 - Torque

Documentation for Torque 3.3

+ +

+ This contains the documentation for Torque 3.3. + The documentation is separated into the different components of Torque + and the different releases of Torque. +

+ - To get information about generating the java classes using Maven 1 + or Maven 2, see the Maven 1 or Maven 2 plugin documentation. +

+ - To learn about generating the java classes using Ant, + see the generator documentation. +

+ - The reference for using the generated classes in your project can + be found in the runtime documentation. +

+ - Information about peculiarities of some databases can be found in the + Database Howtos. +

+ - General howtos spanning several of Torque's components + ara available in the "other Howtos". +

+

+ +

\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/download.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/download.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/download.html (added) +++ db/torque/site-scmpublish/torque-3.3/download.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,171 @@ +Downloading DB Torque - Torque

Download released versions

+

+The currently released versions of Torque are listed below. +

+ +

Binary versions

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionRuntimeGeneratorVillageVillage 3.3.1Maven Plugin
Torque 3.3
TAR + Sig. + MD5TAR + Sig. + MD5TAR + Sig. + MD5 + JAR + Sig. + MD5 + JAR + Sig. + MD5
ZIP + Sig. + MD5ZIP + Sig. + MD5ZIP + Sig. + MD5
+

+
+ +

Source versions

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VersionRuntimeGeneratorVillageVillage 3.3.1Maven Plugin
Torque 3.3TAR + Sig. + MD5TAR + Sig. + MD5TAR + Sig. + MD5 + JAR + Sig.TAR + Sig. + MD5
ZIP + Sig. + MD5ZIP + Sig. + MD5ZIP + Sig. + MD5ZIP + Sig. + MD5
+

+

+ Please check the integrity of the download using the + KEYS file + and the signature files. +

+

+ The PGP signatures can be verified using PGP or GPG. + First download the + KEYS + as well as the asc signature file for the relevant distribution. + Make sure you get these files from the main distribution directory, + rather than from a mirror. Then verify the signatures using e.g. +

+ +
+% pgpk -a KEYS
+% pgpv torque-3.3.tar.gz.asc
+or
+% pgp -ka KEYS
+% pgp torque-3.3.tar.gz.asc
+or
+% gpg --import KEYS
+% gpg --verify torque-3.3.tar.gz.asc 

+
+ + +
+

Older versions

+

+ Older versions of Torque can be found in the + archive. +

+
+

Getting The Development Source From SVN

+

+ You can check out the latest source from the DB SVN module.

+ Torque resides in the db/torque module. + + +

svn checkout http://svn.apache.org/repos/asf/db/torque/trunks
+ + + or browse the source code through ViewCVS. +

+

\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/downloads.html URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/downloads.html?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/downloads.html (added) +++ db/torque/site-scmpublish/torque-3.3/downloads.html Wed Oct 10 03:35:04 2012 @@ -0,0 +1,9 @@ +Downloads - Torque

Downloads

You must define themaven.xdoc.distributionUrlproperty if you wish to generate the download report.


\ No newline at end of file Added: db/torque/site-scmpublish/torque-3.3/dtd/database.dtd URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/dtd/database.dtd?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/dtd/database.dtd (added) +++ db/torque/site-scmpublish/torque-3.3/dtd/database.dtd Wed Oct 10 03:35:04 2012 @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Added: db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_0.dtd URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_0.dtd?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_0.dtd (added) +++ db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_0.dtd Wed Oct 10 03:35:04 2012 @@ -0,0 +1,150 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Added: db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_1.dtd URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_1.dtd?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_1.dtd (added) +++ db/torque/site-scmpublish/torque-3.3/dtd/database_3_0_1.dtd Wed Oct 10 03:35:04 2012 @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Added: db/torque/site-scmpublish/torque-3.3/dtd/database_3_1.dtd URL: http://svn.apache.org/viewvc/db/torque/site-scmpublish/torque-3.3/dtd/database_3_1.dtd?rev=1396460&view=auto ============================================================================== --- db/torque/site-scmpublish/torque-3.3/dtd/database_3_1.dtd (added) +++ db/torque/site-scmpublish/torque-3.3/dtd/database_3_1.dtd Wed Oct 10 03:35:04 2012 @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + --------------------------------------------------------------------- To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org For additional commands, e-mail: torque-dev-help@db.apache.org