From 56bcc6c77911fc862de3668dfe604eb328b6a7a1 Mon Sep 17 00:00:00 2001
From: Tamas Cservenak <tamas@cservenak.net>
Date: Mon, 14 Oct 2024 12:32:44 +0200
Subject: [PATCH] Sprinkle some javadoc

---
 .../plexus/components/secdispatcher/SecDispatcher.java       | 5 +++--
 .../secdispatcher/internal/dispatchers/MasterDispatcher.java | 3 +++
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/main/java/org/codehaus/plexus/components/secdispatcher/SecDispatcher.java b/src/main/java/org/codehaus/plexus/components/secdispatcher/SecDispatcher.java
index ecc0452..fde9fa9 100644
--- a/src/main/java/org/codehaus/plexus/components/secdispatcher/SecDispatcher.java
+++ b/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";
 
diff --git a/src/main/java/org/codehaus/plexus/components/secdispatcher/internal/dispatchers/MasterDispatcher.java b/src/main/java/org/codehaus/plexus/components/secdispatcher/internal/dispatchers/MasterDispatcher.java
index 6c3e2be..ce1fa46 100644
--- a/src/main/java/org/codehaus/plexus/components/secdispatcher/internal/dispatchers/MasterDispatcher.java
+++ b/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;