Javadoc: Use the active voice and small typos.

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

Author: garydgregory

src/main/java/org/apache/commons/codec/language/bm/BeiderMorseEncoder.java

@@ -78,7 +78,7 @@
  * @since 1.6
  */
 public class BeiderMorseEncoder implements StringEncoder {
-    // implementation note: This class is a spring-friendly facade to PhoneticEngine. It allows read/write configuration
+    // Implementation note: This class is a spring-friendly facade to PhoneticEngine. It allows read/write configuration
     // of an immutable PhoneticEngine instance that will be delegated to for the actual encoding.
 
     // a cached object

src/main/java/org/apache/commons/codec/language/bm/Lang.java

@@ -71,7 +71,7 @@
  * @since 1.6
  */
 public class Lang {
-    // implementation note: This class is divided into two sections. The first part is a static factory interface that
+    // Implementation note: This class is divided into two sections. The first part is a static factory interface that
     // exposes the LANGUAGE_RULES_RN resource as a Lang instance. The second part is the Lang instance methods that
     // encapsulate a particular language-guessing rule table and the language guessing itself.
     //

src/main/java/org/apache/commons/codec/language/bm/Languages.java

@@ -53,7 +53,7 @@
  * @since 1.6
  */
 public class Languages {
-    // implementation note: This class is divided into two sections. The first part is a static factory interface that
+    // Iimplementation note: This class is divided into two sections. The first part is a static factory interface that
     // exposes org/apache/commons/codec/language/bm/%s_languages.txt for %s in NameType.* as a list of supported
     // languages, and a second part that provides instance methods for accessing this set fo supported languages.
 

src/main/java/org/apache/commons/codec/language/bm/PhoneticEngine.java

@@ -79,7 +79,7 @@ private PhonemeBuilder(Set<Rule.Phoneme> phonemes) {
         }
 
         /**
-         * Create a new phoneme builder containing all phonemes in this one extended by <code>str</code>.
+         * Creates a new phoneme builder containing all phonemes in this one extended by <code>str</code>.
          *
          * @param str   the characters to append to the phonemes
          * @return  a new phoneme builder lenghened by <code>str</code>
@@ -95,7 +95,7 @@ public PhonemeBuilder append(CharSequence str) {
         }
 
         /**
-         * Create a new phoneme builder containing the application of the expression to all phonemes in this builder.
+         * Creates a new phoneme builder containing the application of the expression to all phonemes in this builder.
          *
          * This will lengthen phonemes that have compatible language sets to the expression, and drop those that are
          * incompatible.
@@ -120,7 +120,7 @@ public PhonemeBuilder apply(Rule.PhonemeExpr phonemeExpr) {
         }
 
         /**
-         * The underlying phoneme set. Please don't mutate.
+         * Gets underlying phoneme set. Please don't mutate.
          *
          * @return  the phoneme set
          */
@@ -129,7 +129,7 @@ public Set<Rule.Phoneme> getPhonemes() {
         }
 
         /**
-         * Stringify the phoneme set. This produces a single string of the strings of each phoneme, joined with a pipe.
+         * Stringifies the phoneme set. This produces a single string of the strings of each phoneme, joined with a pipe.
          * This is explicitly provied in place of toString as it is a potentially expensive operation, which should be
          * avoided when debugging.
          *
@@ -189,8 +189,8 @@ public PhonemeBuilder getPhonemeBuilder() {
         }
 
         /**
-         * This invokes the rules. It loops over the rules list, stopping at the first one that has a matching context
-         * and pattern. It then applies this rule to the phoneme builder to produce updated phonemes. If there was no
+         * Invokes the rules. Loops over the rules list, stopping at the first one that has a matching context
+         * and pattern. Then applies this rule to the phoneme builder to produce updated phonemes. If there was no
          * match, <code>i</code> is advanced one and the character is silently dropped from the phonetic spelling.
          *
          * @return <code>this</code>
@@ -271,7 +271,7 @@ public CharSequence subSequence(int start, int end) {
     }
 
     /**
-     * Join some strings with an internal separater.
+     * Joins some strings with an internal separator.
      * @param strings   Strings to join
      * @param sep       String to separate them with
      * @return          a single String consisting of each element of <code>strings</code> interlieved by <code>sep</code>
@@ -318,7 +318,7 @@ public PhoneticEngine(NameType nameType, RuleType ruleType, boolean concat) {
     }
 
     /**
-     * Apply the final rules to convert from a language-specific phonetic representation to a language-independent
+     * Applies the final rules to convert from a language-specific phonetic representation to a language-independent
      * representation.
      *
      * @param phonemeBuilder