Sprinkle some javadoc

Author: cstamas

src/main/java/org/codehaus/plexus/components/secdispatcher/SecDispatcher.java

@@ -27,14 +27,15 @@
  */
 public interface SecDispatcher {
     /**
-     * Attribute that selects a dispatcher.
+     * Attribute that selects a dispatcher. If not present in {@link #encrypt(String, Map)} attributes, the
+     * configured "default dispatcher" is used.
      *
      * @see #availableDispatchers()
      */
     String DISPATCHER_NAME_ATTR = "name";
 
     /**
-     * Attribute for version that dispatcher should use.
+     * Attribute for version, added by SecDispatcher for possible upgrade path.
      */
     String DISPATCHER_VERSION_ATTR = "version";
 

src/main/java/org/codehaus/plexus/components/secdispatcher/internal/dispatchers/MasterDispatcher.java

@@ -42,6 +42,9 @@ public class MasterDispatcher implements Dispatcher, DispatcherMeta {
 
     private static final String CONF_MASTER_CIPHER = "cipher";
     private static final String CONF_MASTER_SOURCE = "source";
+    /**
+     * Attribute holding the Cipher name used to encrypt the password.
+     */
     private static final String MASTER_CIPHER_ATTR = CONF_MASTER_CIPHER;
 
     private final PlexusCipher cipher;