Fix javadoc warnings

Before this change there were numerous javadoc warnings being reported
while building Spring framework API.

This commit resolves most of the javadoc warnings, reducing the total
number from 265 to 103.

Issue: SPR-9113

spring-jdbc/src/main/java/org/springframework/jdbc/core/JdbcOperations.java

@@ -1012,9 +1012,9 @@ public interface JdbcOperations {
 	 * Each batch should be of size indicated in 'batchSize'.
 	 * @param sql the SQL statement to execute.
 	 * @param batchArgs the List of Object arrays containing the batch of arguments for the query
-	 * @param argTypes SQL types of the arguments
-	 * (constants from <code>java.sql.Types</code>)
-	 * @return an array containing for each batch another array containing the numbers of rows affected 
+	 * @param batchSize batch size
+	 * @param pss ParameterizedPreparedStatementSetter to use
+	 * @return an array containing for each batch another array containing the numbers of rows affected
 	 * by each update in the batch
 	 */
 	public <T> int[][] batchUpdate(String sql, Collection<T> batchArgs, int batchSize, ParameterizedPreparedStatementSetter<T> pss);

spring-jdbc/src/main/java/org/springframework/jdbc/core/ParameterizedPreparedStatementSetter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2011 the original author or authors.
+ * Copyright 2002-2012 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -34,13 +34,13 @@ import java.sql.SQLException;
  * @author Nicolas Fabre
  * @author Thomas Risberg
  * @since 3.1
- * @see JdbcTemplate#batchUpdate(String sql, Collection<T> objs, int batchSize, ParameterizedPreparedStatementSetter<T> pss)
+ * @see JdbcTemplate#batchUpdate(String, java.util.Collection, int, ParameterizedPreparedStatementSetter)
  */
 public interface ParameterizedPreparedStatementSetter<T> {
 
-	/** 
+	/**
 	 * Set parameter values on the given PreparedStatement.
-	 * 
+	 *
 	 * @param ps the PreparedStatement to invoke setter methods on
 	 * @param argument the object containing the values to be set
 	 * @throws SQLException if a SQLException is encountered (i.e. there is no need to catch SQLException)

spring-jdbc/src/main/java/org/springframework/jdbc/datasource/embedded/EmbeddedDatabaseConfigurer.java

@@ -29,7 +29,7 @@ public interface EmbeddedDatabaseConfigurer {
 	
 	/**
 	 * Configure the properties required to create and connect to the embedded database instance.
-	 * @param dataSource the data source to configure
+	 * @param properties connection properties to configure
 	 * @param databaseName the name of the test database
 	 */
 	void configureConnectionProperties(ConnectionProperties properties, String databaseName);