svn commit: r1513323 - in /commons/sandbox/convert/trunk/src: main/java/org/apache/commons/convert/LocalizedConverter.java test/java/org/apache/commons/convert/TestDateTimeConverters.java

[adrianc]

Author: adrianc
Date: Tue Aug 13 02:16:18 2013
New Revision: 1513323

URL: http://svn.apache.org/r1513323
Log:
JavaDocs - no functional change.

Modified:
    
commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
    
commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java

Modified: 
commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
URL: 
http://svn.apache.org/viewvc/commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java?rev=1513323&r1=1513322&r2=1513323&view=diff
==============================================================================
--- 
commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
 (original)
+++ 
commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
 Tue Aug 13 02:16:18 2013
@@ -24,6 +24,12 @@ import java.util.TimeZone;
 /** Localized converter interface. Classes implement this interface
  * to convert one object type to another. Methods are provided to
  * localize the conversion.
+ * <p>Localized converters are necessary for things like dates, times, and 
numbers. Those
+ * conversions are dependent on a locale and/or time zone. Java's default 
conversions
+ * (<code>toString</code>, <code>valueOf</code>) use the JVM's default locale 
and
+ * time zone - which might not be what the application requires. 
Implementations of
+ * <code>LocalizedConverter</code> will use the specified locale and time zone 
instead of
+ * the JVM defaults.</p>
  */
 public interface LocalizedConverter<S, T> extends Converter<S, T> {
     /** Converts <code>obj</code> to <code>T</code>.

Modified: 
commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java
URL: 
http://svn.apache.org/viewvc/commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java?rev=1513323&r1=1513322&r2=1513323&view=diff
==============================================================================
--- 
commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java
 (original)
+++ 
commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java
 Tue Aug 13 02:16:18 2013
@@ -46,7 +46,7 @@ public class TestDateTimeConverters exte
             reflectiveConverter = (Converter<T, S>) 
Converters.getConverter(target.getClass(), source.getClass());
             assertEquals(label + " reflection converted", source, 
reflectiveConverter.convert(target));
         } catch (ClassNotFoundException e) {
-            System.out.println(converter.getClass() + " not reflective");
+            System.out.println(converter.getClass() + " is not reflective");
         }
         try {
             LocalizedConverter<S,T> localizedConverter = (LocalizedConverter) 
converter;