Index: xdocs/maven-howto.xml
===================================================================
RCS file: /home/cvspublic/jakarta-turbine-torque/xdocs/maven-howto.xml,v
retrieving revision 1.2
diff -u -r1.2 maven-howto.xml
--- xdocs/maven-howto.xml 7 Aug 2002 08:07:02 -0000 1.2
+++ xdocs/maven-howto.xml 1 Nov 2002 17:19:47 -0000
@@ -14,138 +14,16 @@
 <p>
   <ol>
     <li>
-      <a href="#About this Example">About this Example</a>
-    </li>
-    <li>
-      <a href="#build.xml">build.xml</a>
-    </li>
-    <li>
-      <a href="#build-torque.xml">build-torque.xml</a>
-    </li>
-    <li>
       <a href="#project.properties">project.properties</a>
     </li>
     <li>
       <a href="#project.xml">project.xml</a>
     </li>
-  </ol>
-</p>
-
-</section>
-
-<section name="About this Example">
-
-<p>
-  This example shows an example configuration for using Torque from it's jar
-  and not having it extracted into the source tree. It also illustrates how to
-  tie in to Maven's callback functionality.
-</p>
-
-<p>
-  Due note that currently this is setup to run Torque on every build. This will
-  get very slow, but in the short future, the <code>build-torque.xml</code>
-  will be updated to check that the XML schema has changed from the last time
-  the SQL/om code was generated so as to save reduplicating the work and greatly
-  improving build time.
-</p>
-
-</section>
-
-<section name="build.xml">
-
-<p>
-  The <code>build.xml</code> file is based on Maven's delegator style of
-  operation. Basically, we had simple targets that forward on to the
-  <code>build-torque.xml</code>.
-</p>
-
-<source><![CDATA[
-<?xml version="1.0"?>
-<project name="yourproject" default="maven:war" basedir=".">
-  <property file="${user.home}/build.properties"/>
-  <property file="build.properties"/>
-  <property file="project.properties"/>
-
-  <!-- Tie Torque into Maven -->
-  <property name="maven.core.callback.pre-compile.buildFile" value="build.xml"/>
-  <property name="maven.core.callback.pre-compile.buildTarget" value="torque:main"/>
-  
-  ...
-
-  <!-- Maven Delegators -->
-
-  ...
-
-  <!-- torque:start -->
-
-  <target name="torque:main">
-    <ant antfile="build-torque.xml" target="main"/>
-  </target>
-
-  <target name="torque:sql">
-    <ant antfile="build-torque.xml" target="sql"/>
-  </target>
-
-  <target name="torque:doc">
-    <ant antfile="build-torque.xml" target="doc"/>
-  </target>
-
-  <target name="torque:create-db">
-    <ant antfile="build-torque.xml" target="create-db"/>
-  </target>
-
-  <target name="torque:insert-sql">
-    <ant antfile="build-torque.xml" target="insert-sql"/>
-  </target>
-
-  <target name="torque:jdbc">
-    <ant antfile="build-torque.xml" target="jdbc"/>
-  </target>
-
-  <target name="torque:datasql">
-    <ant antfile="build-torque.xml" target="datasql"/>
-  </target>
-
-  <target name="torque:id-table-init-sql">
-    <ant antfile="build-torque.xml" target="id-table-init-sql"/>
-  </target>
-
-  <target name="torque:datadump">
-    <ant antfile="build-torque.xml" target="datadump"/>
-  </target>
-
-  <target name="torque:datadtd">
-    <ant antfile="build-torque.xml" target="datadtd"/>
-  </target>
-
-  <target name="torque:om">
-    <ant antfile="build-torque.xml" target="om"/>
-  </target>
-
-  <target name="torque:sql2xml">
-    <ant antfile="build-torque.xml" target="sql2xml"/>
-  </target>
-
-  <target name="torque:ojb-repository">
-    <ant antfile="build-torque.xml" target="ojb-repository"/>
-  </target>
-
-  <target name="torque:ojb-model">
-    <ant antfile="build-torque.xml" target="ojb-model"/>
-  </target>
-
-  <!-- torque:end -->
-]]></source>
-
-</section>
-
-<section name="build-torque.xml">
+    <li>
+      <a href="#Other Tips">Other Tips</a>
+    </li>
 
-<p>
-  <code>build-torque.xml</code> actually requires no editting. You merely
-  have to extract it from the Torque jar and put it in the project directory.
-  All of the other jar contents can be ignored as they'll be read from
-  the jar in the <code>${lib.repo}</code>.
+  </ol>
 </p>
 
 </section>
@@ -310,6 +188,14 @@
 ]]></source>
 
 </section>
+<section name="Other Tips">
 
+<p>
+  Make sure that you have placed the most recent version of Torque into your MAVEN_HOME/repository/torque/jars directory.
+</p>
+<p>
+  Don't place your project-schema.xml file in a directory with other files.  That can lead to various DTD errors.
+</p>
+</section>
   </body>
 </document>

