db-torque-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From henn...@apache.org
Subject svn commit: r239595 - in /db/torque/site/xdocs: navigation.xml subversion.xml
Date Wed, 24 Aug 2005 10:11:49 GMT
Author: henning
Date: Wed Aug 24 03:11:45 2005
New Revision: 239595

URL: http://svn.apache.org/viewcvs?rev=239595&view=rev
Log:
add some quick notes about torque subversion repo


Added:
    db/torque/site/xdocs/subversion.xml   (with props)
Modified:
    db/torque/site/xdocs/navigation.xml

Modified: db/torque/site/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/db/torque/site/xdocs/navigation.xml?rev=239595&r1=239594&r2=239595&view=diff
==============================================================================
--- db/torque/site/xdocs/navigation.xml (original)
+++ db/torque/site/xdocs/navigation.xml Wed Aug 24 03:11:45 2005
@@ -15,6 +15,7 @@
       <item name="Overview"              href="/index.html"/>
       <item name="News and Status"       href="/status.html"/>
       <item name="Downloads"             href="/download.html"/>
+      <item name="Subversion / CVS"      href="/subversion.html"/>
       <item name="Wiki"                  href="http://wiki.apache.org/db-torque/"/>
     </menu>
 

Added: db/torque/site/xdocs/subversion.xml
URL: http://svn.apache.org/viewcvs/db/torque/site/xdocs/subversion.xml?rev=239595&view=auto
==============================================================================
--- db/torque/site/xdocs/subversion.xml (added)
+++ db/torque/site/xdocs/subversion.xml Wed Aug 24 03:11:45 2005
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<document>
+  <properties>
+    <title>Torque</title>
+    <author email="hps@intermeta.de">Henning P. Schmiedehausen</author>
+  </properties>
+
+  <body>
+   <section name="Torque Source code management">
+     <p>
+      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 <a
+      href="http://subversion.tigris.org">Subversion</a>.
+    </p>
+
+    <p>
+      If you have never worked with Subversion before, please take a
+      look at <a href="http://svnbook.red-bean.com/">the free
+      subversion book</a> and also at <a
+      href="http://www.apache.org/dev/version-control.html">Source
+      code repositories at the Apache Software Foundation</a> to get
+      more information.
+    </p>
+   </section>
+
+   <section name="The Torque repository">
+    <p>
+     Unlike some other repositories you might know, Torque makes some
+     use of the <a
+     href="http://svnbook.red-bean.com/en/1.1/ch07s04.html">svn:externals</a>
+     feature of Subversion to organize its tree. This might lead to
+     some &quot;gotchas&quot;, so be warned.
+    </p>
+
+    <subsection name="Torque Modules">
+     <p>
+      Torque contains the following modules:
+
+      <table>
+       <tr><th>Module</th><th>Subversion repository</th></tr>
+
+       <tr><td>Runtime</td>     <td><a href="http://svn.apache.org/viewcvs/db/torque/runtime/trunk/">http://svn.apache.org/repos/asf/db/torque/runtime/trunk</a></td></tr>
+       <tr><td>Generator</td>   <td><a href="http://svn.apache.org/viewcvs/db/torque/generator/trunk/">http://svn.apache.org/repos/asf/db/torque/generator/trunk/</a></td></tr>
+       <tr><td>Templates</td>   <td><a href="http://svn.apache.org/viewcvs/db/torque/templates/trunk/">http://svn.apache.org/repos/asf/db/torque/templates/trunk/</a></td></tr>
+       <tr><td>Maven-Plugin</td><td><a href="http://svn.apache.org/viewcvs/db/torque/maven-plugin/trunk/">http://svn.apache.org/repos/asf/db/torque/maven-plugin/trunk/</a></td></tr>
+       <tr><td>Site</td>        <td><a href="http://svn.apache.org/viewcvs/db/torque/site/">http://svn.apache.org/repos/asf/db/torque/site/</a></td></tr>
+       <tr><td>Common</td>      <td><a href="http://svn.apache.org/viewcvs/db/torque/common/trunk/">http://svn.apache.org/repos/asf/db/torque/common/trunk/</a></td></tr>
+      </table>
+     </p>
+    </subsection>
+
+    <subsection name="Runtime, Generator, Templates, Maven-Plugin">
+     <p>
+      These modules make up the main torque distribution. They
+      are released in regular intervals and are available as binary
+      and source distributions from <a href="/download.html">the
+      Torque download page</a>. Each of these modules is developed
+      on its own Subversion trunk; Tags and Branches are located in
+      the respective <code>.../tags</code> and <code>.../branches</code>
subdirectories.
+     </p>
+    </subsection>
+
+    <subsection name="Common">
+     <p>
+      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 <code>/common/...</code> <br/>
+      Please be aware that every change
+      inside this module influences the build process of all the
+      Torque modules!.
+     </p>
+    </subsection>
+    <subsection name="Site">
+     <p>
+      The Torque site contains the information global to all Torque
+      releases such as main navigation, download page or the page
+      you're currently reading. It has no branches or tags.
+     </p>
+    </subsection>
+   </section>
+
+   <section name="Old CVS tags and branches">
+    <p>
+     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.
+
+     <ul>
+      <li><a href="http://svn.apache.org/viewcvs/db/torque/tags/">Old CVS Tags</a>
-- http://svn.apache.org/repos/asf/db/torque/tags/</li>
+      <li><a href="http://svn.apache.org/viewcvs/db/torque/branches/">Old CVS
Branches</a> -- http://svn.apache.org/repos/asf/db/torque/branches/</li>
+     </ul>
+     </p>
+   </section>
+      
+   <section name="The trunks module">
+    <p>
+     The Torque subversion repository contains another module for
+     development called <i>trunks</i>. While
+     this module seems quite empty, it is not.<br/>
+     If you want to work on the Torque code base, your best guess will be to
+     check out this module using
+
+     <source><![CDATA[svn checkout http://svn.apache.org/repos/asf/db/torque/trunks
torque]]></source>
+
+     The resulting directory will contain the trunk locations of all
+     main Torque parts. This also happens through svn:external
+     references.
+    </p>
+   </section>
+
+   <section name="Multi-Project build">
+    <p>
+     The <i>trunks</i> module also contains a <a
+     href="http://maven.apache.org/reference/plugins/multiproject/">Multi-Project</a>
+     build environment to build all the major parts of Torque in one
+     go.<br/>
+     If you checked out the <i>trunks</i> module from subversion, you can run
one of
+     the following goals inside the resulting directory:
+
+     <ul>
+      <li>build -- Builds all parts of Torque</li>
+      <li>install - Builds all parts of Torque and installs the resulting jars and
plugins into your local maven repository</li>
+      <li>doc -- Builds the documentation sites for all parts of Torque</li>
+     </ul>
+    </p>
+   </section>
+
+   <section name="Runtime Test">
+    <p>
+     The <i>runtime</i> module contains the Torque runtime test, which
+     tests all aspects of the runtime, generator and templates. If you
+     want to run this test (executing the runtime:test goal), it must
+     be aware of the locations of the generator and template
+     source. Easiest way to do so is running it from the
+     <i>trunks/runtime</i> module. <br/>
+     If you have a different source layout and want to run the runtime test, you must adjust
the <code>torque.generator.home</code> and <code>torque.templates.home</code>
properties
+     in the <code>project.properties</code> file inside the <i>runtime</i>
module.
+    </p>
+   </section>
+  </body>
+</document>

Propchange: db/torque/site/xdocs/subversion.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: db/torque/site/xdocs/subversion.xml
------------------------------------------------------------------------------
    svn:keywords = Id Author



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


Mime
View raw message