Better Javadoc.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/codec/trunk@1079533 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/java/org/apache/commons/codec/StringEncoderComparator.java

@@ -40,11 +40,12 @@ public class StringEncoderComparator implements Comparator {
 
     /**
      * Constructs a new instance.
-     * @deprecated as creating without a StringEncoder will lead to a 
-     *             broken NullPointerException creating comparator.
+     * 
+     * @deprecated Creating an instance without a {@link StringEncoder} leads to a {@link NullPointerException}. Will be
+     *             removed in 2.0.
      */
     public StringEncoderComparator() {
-        this.stringEncoder = null;   // Trying to use this will cause things to break
+        this.stringEncoder = null; // Trying to use this will cause things to break
     }
 
     /**