<?xml version="1.0" encoding="UTF-8"?>
<!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
 distributed with this work for additional information
 regarding copyright ownership.  The ASF licenses this file
 to you under the Apache License, Version 2.0 (the
 "License"); you may not use this file except in compliance
 with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing,
 software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 KIND, either express or implied.  See the License for the
 specific language governing permissions and limitations
 under the License.
-->

<document>

  <properties>
    <title>News and Status</title>
    <author email="mpoeschl@marmot.at">Martin Poeschl</author>
    <author email="seade@backstagetech.com.au">Scott Eade</author>
    <author email="hps@intermeta.de">Henning P. Schmiedehausen</author>
    <author email="fischer@seitenbau.de">Thomas Fischer</author>
  </properties>

  <body>

    <section name="News and Status">
      <p>
        This document contains the latest news and status regarding the
        Torque project.  It is here that you'll find announcements related to
        Torque.
      </p>

      <subsection name="20 September 2012 - Torque-4.0-beta1 released">
        <p>
          This release of the Torque 4 branch allows feedback
          before the 4.0 release.
          The main changes with respect to Torque 3.3 are:
        </p>
        <ul>
          <li>The "look and feel" of Torque 3 was maintained.</li>
          <li>The generator is now a general-purpose code generator.</li>
          <li>
            As the templates are now modular, it is easy to extend or modify
            the generated code without having to replace the whole templates.
          </li>
          <li>
            A new Criteria implementation was created, with slightly 
            changed semantics. 
            The old Criteria implementation was retained but deprecated.
          </li>
          <li>Prepared statements are sued throughout all queries.</li>
          <li>Column names are now encapsulated in objects.</li>
        </ul>
      </subsection>

      <subsection name="18 February 2011 - Village 3.3.1 released">
        <p>
          Village is the bridge between Torque and the JDBC-API. This release
          fixes some long outstanding bugs and can be used as a drop-in
          replacement for village-3.3. The source and binaries are available in
          the
          <a href="http://repo1.maven.org/maven2/org/apache/torque/village/3.3.1/">Maven Repository</a>
        </p>
        
        <p>
          Changes in this version:
          <ul>
            <li>Fixed: Case sensitivity issues with cached metadata.</li>
            <li>Fixed: Getting the metadata from a prepared statement without
            execution does not work with Oracle.</li>
            <li>Fixed: Use cached metadata when running selects. Metadata can be loaded
            into the cache with Schema.initSchemas(Connection)  Issue: TORQUE-36.</li>
            <li>Fixed: Statement is left open when Exception is thrown in the
            QueryDataSet constructor.  Issue: TORQUE-123.</li>
            <li>Fixed: Village does not close every resultSet it opens.  Issue: TORQUE-8.</li>
            <li>Deal with situation arising in jre1.6.0_18 where an
            IllegalArgumentException is encountered for dates with a single digit
            month or day of month.  Issue: TORQUE-133.</li>
            <li>Fixed the infamous NPE when Oracle returns null for a blob.</li>
          </ul>
        </p>
      </subsection>

      <subsection name="07 September 2008 - Torque 4 branch created">
        <p>
          The idea of Torque 4 is to allow major reworking of the internals
          of Torque 3. The usage of Torque should not change much,
          however, some more exotic features could change.
          Details on Torque 4 can be found on the
          <a href="http://db.apache.org/torque/releases/torque-4.0/index.html">Torque 4 site</a>
        </p>
      </subsection>

      <subsection name="29 February 2008 - Torque 3.3 final is released!">
        <p>
          This version is virtually identical to 3.3-RC3. The Torque community has
          voted to use this release candidate as final release.
        </p>
        <p> 
          You can obtain the Torque 3.3 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a href="http://ibiblio.org/maven/torque/" class="externalLink" title="External Link">ibiblio maven
          repository</a>. Please refer for the full changes to the
          changes reports at <a href="changes-report.html">Changes Report</a>.
        </p>
      </subsection>

      <subsection name="11 January 2008 - Torque 3.3-rc3 is released!">
        <p>
          This version contains a fair number of fixes against 3.3-RC2, among them
          the integtration of the Village library into the Torque project. Others are 
          <ul>
            <li>
              Improvements and fixes for the Maven2-plugin
            </li>
            <li>
              Several improvements and corrections to templates to improve
              SQL and Java code generation for different databases, namely Sybase
              and MS-SQL.
            </li>
            <li>
              Improvements and corrections to the templates.
            </li>
            <li>
              and much more...
            </li>
          </ul>
          You can obtain the Torque 3.3-rc3 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a href="http://ibiblio.org/maven/torque/" class="externalLink" title="External Link">ibiblio maven
          repository</a>. Please refer for the full changes to the
          changes reports at <a href="changes-report.html">Changes Report</a>.
        </p>
      </subsection>
      <subsection name="26 February 2007 - Torque 3.3-rc2 is released!">
        <p>
          This version contains a couple of fixes against 3.3-RC1, namely
          <ul>
            <li>
              A fix for the handling of the <code>interface</code> attribute
              of tables.
            </li>
            <li>
              Improvements and fixes for the Maven2-plugin
            </li>
            <li>
              Several improvements and corrections to templates to improve
              SQL and Java code generation for different databases. Packages
              should now be taken care of everywhere.
            </li>
            <li>
              Centralization of the MapBuilder handling to allow repeated
              initialization/shutdown cycles.
            </li>
            <li>
              and much more...
            </li>
          </ul>
          You can obtain the Torque 3.3-rc2 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a href="http://ibiblio.org/maven/torque/" class="externalLink" title="External Link">ibiblio maven
          repository</a>. Please refer for the full changes to the
          changes reports at <a href="changes-report.html">Changes Report</a>.
        </p>
      </subsection>
      <subsection name="10 February 2007 - Maven 1.0.x Dependency Problems">
        <p>
          Maven default repository has moved and now Maven 1.0.x is 
          unable to find required dependencies without a minor configuration
          change.  You will need to add the following to your 
          project.properties file:
          <ul>
          maven.repo.remote=http://repo1.maven.org/maven
          </ul>
        A good place to do add this is in your user id's default 
        Maven project.properties file.  This is in your user home 
        directory, e.g. C:\Documents and Settings\userid on Windows
        or ~userid on *nix.  If it doesn't exist, just create one 
        with just that line.
        </p>
        <p>For more information see <a href="http://maven.apache.org/maven-1.x/news.html">the Maven 1.1 Site.</a>
        </p>
      </subsection>

      <subsection name="23 November 2006 - Torque 3.3-rc1 is released!">
        <p>
          The most prominent changes are:
          <ul>
            <li>
              A maven-2 plugin.
            </li>
            <li>
              Added better support for Apache Derby.
            </li>
            <li>
              A lot of improvements and corrections have been made to 
              the support of different databases, namely MS-SQL, Oracle
              and Firebird.
            </li>
            <li>
              Added support for option tags in most elements of database.dtd
            </li>
            <li>
              Preserve case of column names in constants (can be switched off
              in the configuration)
            </li>
            <li>
              Subqueries are now supported in Criteria.
            </li>
            <li>
              Added setByName, setByPeerName, and setByPosition methods to OM classes.
            </li>
            <li>
              Added optional support for Java5 generics support in the generated classes
            </li>
            <li>
              Build process reworked to make template/generator class add-ons/local mods
              easier.
            </li>
          </ul>
          You can obtain the Torque 3.3-rc1 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a href="http://ibiblio.org/maven/torque/" class="externalLink" title="External Link">ibiblio maven
          repository</a>. Please refer for the full changes to the
          changes reports at <a href="changes-report.html">Changes Report</a>.
        </p>
      </subsection>
      <subsection name="08 December 2005 - Torque 3.2 is released!">
        <p>
          The most prominent changes since 3.1.1 are:
          <ul>
            <li>
              Added database schema support, both in the generator
              and in the runtime
            </li>
            <li>
              Added support for outer joins
            </li>
            <li>
              Added support for creation of simple java beans
              from persistent objects
            </li>
            <li>
              The old connection pool is removed
              (only dbcp is supported out of the box)
            </li>
            <li>
              Some smaller changes were made in the database.dtd
            </li>
            <li>
              The build-torque ant file for the generator
              is contained again in the generator release
            </li>
          </ul>         
        </p>
        
        <p>
          You can obtain the Torque 3.2 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.<br/>
          This is the renamed rc3.
          Please refer to 
          <a href="changes-report.html">
          the Changes report</a> for a full list of changes and fixed bugs.
        </p>
      </subsection>

      <subsection name="13 November 2005 - Torque 3.2-rc3 is released!">
        <p>
          You can obtain the Torque 3.2-rc3 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.<br/>
          The focus of this release candidate was fixing bugs in 3.2-rc2. 
          Please refer to 
          <a href="changes-report.html">
          the Changes report</a> for a full list of changes and fixed bugs.
        </p>
      </subsection>

      <subsection name="13 September 2005 - Torque 3.2-rc2 is released!">
        <p>
          You can obtain the Torque 3.2-rc2 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.<br/>
          Please refer to <a
          href="changes-report.html">the Changes report</a> for a full
          list of changes.
        </p>
      </subsection>

      <subsection name="19 July 2005 - Torque 3.2-rc1 is released!">
        <p>
          The most prominent changes are:
          <ul>
            <li>
              Added database schema support, both in the generator
              and in the runtime
            </li>
            <li>
              Added support for outer joins
            </li>
            <li>
              Added support for creation of simple java beans
              from persistent objects
            </li>
            <li>
              The old connection pool is removed
              (only dbcp is supported out of the box)
            </li>
            <li>
              Some smaller changes were made in the database.dtd
            </li>
            <li>
              The build-torque ant file for the generator
              is contained again in the generator release
            </li>
          </ul>
          You can obtain the Torque 3.2-rc1 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>. Please refer for the full changes to the
          changes reports at <a href="changes-report.html">Changes Report</a>.
        </p>
      </subsection>

      <subsection name="26 October 2004 - Torque 3.1.1 is released!">
        <p>
          You can obtain the Torque 3.1.1 generator, runtime and
          maven-plugin from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.<br/>
          This is a bugfix release. The docs including a full list of changes are available
          <a href="/releases/torque-3.1.1/index.html">here</a>
          Please refer to <a
          href="changes-report.html">the Changes report</a> for a full
          list of changes.
        </p>
      </subsection>

      <subsection name="16 October 2004 - Torque 3.1.1-rc3 is released!">
        <p>
          You can obtain the Torque 3.1.1-rc3 generator, runtime and
          maven-plugin from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.
        </p>
      </subsection>

      <subsection name="27 August 2004 - Torque 3.1.1-rc2 is released!">
        <p>
          A problem handling limit and offset has been corrected.  You can
          obtain the Torque 3.1.1-rc2 generator, runtime and maven-plugin from
          the <a href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.
        </p>
      </subsection>

      <subsection name="26 August 2004 - Torque 3.1.1-rc1 is released!">
        <p>
          We are working on setting up the mirrored download page for 3.1.1
          final.  In the mean time you can obtain the Torque 3.1.1-rc1
          generator, runtime and maven-plugin from the
          <a href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.
        </p>
      </subsection>

      <subsection name="In Memoriam">
        <p>
          <a href="http://www.apache.org/foundation/martin.html">Farewell to
          Martin Pöschl</a>.
        </p>
      </subsection>

      <subsection name="1 September 2003 - Torque 3.1 is released!">
        <p>
          You can obtain the Torque 3.1 release from our <a href="download.html">Download
          page</a> or from the <a
          href="http://ibiblio.org/maven/torque/">ibiblio maven
          repository</a>.<br/>
          The docs including a full list of changes are available
          <a href="/releases/torque-3.1/index.html">here</a>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.1/">
          here</a>.
        </p>
      </subsection>

      <subsection name="26 August 2003 - Torque 3.1-rc is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.1-rc/">
          here</a>.
        </p>
      </subsection>

      <subsection name="19 August 2003 - Torque 3.1-beta1 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.1-beta1/">
          here</a>.
        </p>
      </subsection>

      <subsection name="29 June 2003 - Torque 3.1-alpha2 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.1-alpha2/">
          here</a>.
        </p>
      </subsection>

      <subsection name="20 June 2003 - Torque 3.0.2 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0.2/">
          here</a>. <br/>
          This is a bugfix release. The full list of changes is available
          <a href="changes-report.html">here</a>
        </p>
      </subsection>

      <subsection name="05 June 2003 - Torque 3.0.1 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0.1/">
          here</a>. <br/>
          This is a bugfix release. The full list of changes is available
          <a href="changes-report.html">here</a>
        </p>
      </subsection>

      <subsection name="17 April 2003 - Torque 3.1-alpha1 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.1-alpha1/">
          here</a>.
        </p>
      </subsection>

      <subsection name="06 December 2002 - Torque 3.0 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0/">
          here</a>.
        </p>
      </subsection>

      <subsection name="20 November 2002 - Torque 3.0 Release Candidate 2 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-rc2/">
          here</a>.
        </p>
      </subsection>

      <subsection name="26 October 2002 - Torque 3.0 Release Candidate 1 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-rc1/">
          here</a>.
        </p>
      </subsection>

      <subsection name="22 August 2002 - Torque 3.0 Beta 4 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-b4/">
          here</a>.
        </p>
      </subsection>

      <subsection name="17 July 2002 - Torque 3.0 Beta 3 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-b3/">
          here</a>.
        </p>
      </subsection>

      <subsection name="26 Juni 2002 - Torque 3.0 Beta 2 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-b2/">
          here</a>.
        </p>
      </subsection>

      <subsection name="19 March 2002 - Torque 3.0 Beta 1 is released!">
        <p>
          Downloads are available <a href="http://db.apache.org/builds/torque/release/3.0-b1/">
          here</a>.
        </p>
      </subsection>
    </section>
  </body>
</document>
