Improve Javadoc

Author: purejava

src/main/java/org/cryptomator/integrations/keychain/KeychainAccessProvider.java

@@ -25,7 +25,9 @@ public interface KeychainAccessProvider {
 	 * Associates a passphrase with a given key and a name for that key.
 	 *
 	 * @param key         Key used to retrieve the passphrase via {@link #loadPassphrase(String)}.
-	 * @param displayName The according name to the key.
+	 * @param displayName The according name to the key. That's the name of the vault displayed in the UI.
+	 *                    It's passed to the keychain as an additional information about the vault besides the key.
+	 *                    The parameter does not need to be unique or be checked by the keychain.
 	 * @param passphrase  The secret to store in this keychain.
 	 * @throws KeychainAccessException If storing the password failed
 	 */
@@ -61,7 +63,9 @@ default void storePassphrase(String key, String displayName, CharSequence passph
 	 * Updates a passphrase with a given key and stores a name for that key. Noop, if there is no item for the given key.
 	 *
 	 * @param key         Unique key previously used while {@link #storePassphrase(String, CharSequence) storing a passphrase}.
-	 * @param displayName The according name to the key.
+	 * @param displayName The according name to the key. That's the name of the vault displayed in the UI.
+	 *                    It's passed to the keychain as an additional information about the vault besides the key.
+	 *                    The parameter does not need to be unique or be checked by the keychain.
 	 * @param passphrase  The secret to be updated in this keychain.
 	 * @throws KeychainAccessException If changing the password failed
 	 */