I disagree with that. Javadocs are already bad enough to write without having to deal with FQCNs. FWIW, I always used imports.
Gary ---------- Forwarded message ---------- From: <brit...@apache.org> Date: Wed, Jul 16, 2014 at 2:05 PM Subject: svn commit: r1611119 - /commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java To: comm...@commons.apache.org Author: britter Date: Wed Jul 16 18:05:42 2014 New Revision: 1611119 URL: http://svn.apache.org/r1611119 Log: Use qualified class names instead of importing class just for documentation Modified: commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java Modified: commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java URL: http://svn.apache.org/viewvc/commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java?rev=1611119&r1=1611118&r2=1611119&view=diff ============================================================================== --- commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java (original) +++ commons/proper/dbutils/trunk/src/main/java/org/apache/commons/dbutils/QueryLoader.java Wed Jul 16 18:05:42 2014 @@ -19,7 +19,6 @@ package org.apache.commons.dbutils; import java.io.IOException; import java.io.InputStream; import java.util.HashMap; -import java.util.InvalidPropertiesFormatException; import java.util.Map; import java.util.Properties; import java.util.regex.Pattern; @@ -76,7 +75,7 @@ public class QueryLoader { * @throws IOException if a file access error occurs * @throws IllegalArgumentException if the ClassLoader can't find a file at * the given path. - * @throws InvalidPropertiesFormatException if the XML properties file is + * @throws java.util.InvalidPropertiesFormatException if the XML properties file is * invalid * @return Map of query names to SQL values * @see java.util.Properties @@ -103,7 +102,7 @@ public class QueryLoader { * @throws IOException if a file access error occurs * @throws IllegalArgumentException if the ClassLoader can't find a file at * the given path. - * @throws InvalidPropertiesFormatException if the XML properties file is + * @throws java.util.InvalidPropertiesFormatException if the XML properties file is * invalid * @since DbUtils 1.1 * @return Map of query names to SQL values -- E-Mail: garydgreg...@gmail.com | ggreg...@apache.org Java Persistence with Hibernate, Second Edition <http://www.manning.com/bauer3/> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/> Spring Batch in Action <http://www.manning.com/templier/> Blog: http://garygregory.wordpress.com Home: http://garygregory.com/ Tweet! http://twitter.com/GaryGregory