From cf259728351285d630b0db5f0a6e2367d58dbb03 Mon Sep 17 00:00:00 2001
From: bernd <rbernd@gmail.com>
Date: Wed, 14 Nov 2012 21:24:30 +0100
Subject: [PATCH 03/25] Make javadoc of QueryTool.update() methods more
 readable and add @since tag.

---
 eodsql/src/net/lemnik/eodsql/QueryTool.java | 44 ++++++++++++++++-------------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/eodsql/src/net/lemnik/eodsql/QueryTool.java b/eodsql/src/net/lemnik/eodsql/QueryTool.java
index 6766bc6..f6e4f8e 100644
--- a/eodsql/src/net/lemnik/eodsql/QueryTool.java
+++ b/eodsql/src/net/lemnik/eodsql/QueryTool.java
@@ -600,13 +600,14 @@ public class QueryTool {
 
     /**
      *<p>
-     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query interface allows. Although this method
-     * is significantly slower than building a Query interface, it provides needed functionality that a Query
-     * interface cannot.
+     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query 
+     * interface allows. Although this method is significantly slower than building a Query interface, 
+     * it provides needed functionality that a Query interface cannot.
      *</p><p>
-     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. It however
-     * provides the same primitive-type abstraction that a Query interface provides you with. The query string is
-     * parsed in the same way as a query string passed to an {@link Select @Select} annotation.
+     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. 
+     * It however provides the same primitive-type abstraction that a Query interface provides you with. 
+     * The query string is parsed in the same way as a query string passed to an {@link Select @Select} 
+     * annotation.
      *</p>
      *
      * @param connection the <code>Connection</code> to use to perform the query
@@ -622,6 +623,7 @@ public class QueryTool {
      *      be parsed, or doesn't match the given parameters
      * @throws IllegalArgumentException is the <code>DataSource</code>
      *      provided is <code>null</code>
+     * @since 2.2
      */
     public static int update(
             final Connection connection,
@@ -657,13 +659,14 @@ public class QueryTool {
 
     /**
      *<p>
-     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query interface allows. Although this method
-     * is significantly slower than building a Query interface, it provides needed functionality that a Query
-     * interface cannot.
+     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query 
+     * interface allows. Although this method is significantly slower than building a Query interface, 
+     * it provides needed functionality that a Query interface cannot.
      *</p><p>
-     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. It however
-     * provides the same primitive-type abstraction that a Query interface provides you with. The query string is
-     * parsed in the same way as a query string passed to an {@link Select @Select} annotation.
+     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. 
+     * It however provides the same primitive-type abstraction that a Query interface provides you with. 
+     * The query string is parsed in the same way as a query string passed to an {@link Select @Select} 
+     * annotation.
      *</p>
      *
      * @param dataSource the <code>DataSource</code> to use get the connection from to perform the query
@@ -679,6 +682,7 @@ public class QueryTool {
      *      be parsed, or doesn't match the given parameters
      * @throws IllegalArgumentException is the <code>DataSource</code>
      *      provided is <code>null</code>
+     * @since 2.2
      */
     public static int update(
             final DataSource dataSource,
@@ -714,15 +718,14 @@ public class QueryTool {
 
     /**
      *<p>
-     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query interface allows. Although this method
-     * is significantly slower than building a Query interface, it provides needed functionality that a Query
-     * interface cannot.
-     *</p><p>
-     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. It however
-     * provides the same primitive-type abstraction that a Query interface provides you with. The query string is
-     * parsed in the same way as a query string passed to an {@link Select @Select} annotation.
+     * Sometimes you need to perform a less structured "UPDATE", "INSERT" or "DELETE" than a Query 
+     * interface allows. Although this method is significantly slower than building a Query interface, 
+     * it provides needed functionality that a Query interface cannot.
      *</p><p>
-     * This method is the same as calling <code>update(getDefaultDataSource(), query, parameters)</code>.
+     * This method does no caching of any sort, and the query will be re-parsed each time it is executed. 
+     * It however provides the same primitive-type abstraction that a Query interface provides you with. 
+     * The query string is parsed in the same way as a query string passed to an {@link Select @Select} 
+     * annotation.
      *</p>
      *
      * @param query the SQL query to be executed
@@ -737,6 +740,7 @@ public class QueryTool {
      *      be parsed, or doesn't match the given parameters
      * @throws IllegalArgumentException is the <code>DataSource</code>
      *      provided is <code>null</code>
+     * @since 2.2
      */
     public static int update(
             final String query,
-- 
1.8.0