Clarify Javadoc for deprecation notice.

Author: lizroth

src/main/java/com/amazonaws/encryptionsdk/AwsCrypto.java

@@ -282,9 +282,9 @@ public <K extends MasterKey<K>> CryptoResult<byte[], K> encryptData(final Master
      * Calls {@link #encryptData(MasterKeyProvider, byte[], Map)} on the UTF-8 encoded bytes of
      * {@code plaintext} and base64 encodes the result.
      * @deprecated Use the {@link #encryptData(MasterKeyProvider, byte[], Map)} and
-     * {@link #decryptData(MasterKeyProvider, byte[])} APIs instead. {@code encryptString} is incompatible with the
-     * other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #decryptData(MasterKeyProvider, byte[])} APIs instead. {@code encryptString} and {@code decryptString}
+     * require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK implementations. Data
+     * encoding is an application-specific choice. These deprecated APIs will be removed in the future.
      */
     @Deprecated
     public <K extends MasterKey<K>> CryptoResult<String, K> encryptString(
@@ -301,9 +301,9 @@ public <K extends MasterKey<K>> CryptoResult<String, K> encryptString(
      * Calls {@link #encryptData(CryptoMaterialsManager, byte[], Map)} on the UTF-8 encoded bytes of
      * {@code plaintext} and base64 encodes the result.
      * @deprecated Use the {@link #encryptData(CryptoMaterialsManager, byte[], Map)} and
-     * {@link #decryptData(CryptoMaterialsManager, byte[])} APIs instead. {@code encryptString} is incompatible with the
-     * other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #decryptData(CryptoMaterialsManager, byte[])} APIs instead. {@code encryptString} and {@code decryptString}
+     * require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK implementations. Data
+     * encoding is an application-specific choice. These deprecated APIs will be removed in the future.
      */
     @Deprecated
     public CryptoResult<String, ?> encryptString(
@@ -324,9 +324,9 @@ public <K extends MasterKey<K>> CryptoResult<String, K> encryptString(
      * Returns the equivalent to calling {@link #encryptString(MasterKeyProvider, String, Map)} with
      * an empty {@code encryptionContext}.
      * @deprecated Use the {@link #encryptData(MasterKeyProvider, byte[])} and
-     * {@link #decryptData(MasterKeyProvider, byte[])} APIs instead. {@code encryptString} is incompatible with the
-     * other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #decryptData(MasterKeyProvider, byte[])} APIs instead. {@code encryptString} and {@code decryptString}
+     * require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK implementations. Data
+     * encoding is an application-specific choice. These deprecated APIs will be removed in the future.
      */
     @Deprecated
     public <K extends MasterKey<K>> CryptoResult<String, K> encryptString(final MasterKeyProvider<K> provider,
@@ -338,9 +338,9 @@ public <K extends MasterKey<K>> CryptoResult<String, K> encryptString(final Mast
      * Returns the equivalent to calling {@link #encryptString(CryptoMaterialsManager, String, Map)} with
      * an empty {@code encryptionContext}.
      * @deprecated Use the {@link #encryptData(CryptoMaterialsManager, byte[])} and
-     * {@link #decryptData(CryptoMaterialsManager, byte[])} APIs instead. {@code encryptString} is incompatible with the
-     * other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #decryptData(CryptoMaterialsManager, byte[])} APIs instead. {@code encryptString} and {@code decryptString}
+     * require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK implementations. Data
+     * encoding is an application-specific choice. These deprecated APIs will be removed in the future.
      */
     @Deprecated
     public CryptoResult<String, ?> encryptString(
@@ -423,9 +423,10 @@ public <K extends MasterKey<K>> CryptoResult<byte[], K> decryptData(
      *
      * @see #decryptData(MasterKeyProvider, byte[])
      * @deprecated Use the {@link #decryptData(MasterKeyProvider, byte[])} and
-     * {@link #encryptData(MasterKeyProvider, byte[], Map)} APIs instead. {@code decryptString} is incompatible with
-     * the other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #encryptData(MasterKeyProvider, byte[], Map)} APIs instead. {@code encryptString} and
+     * {@code decryptString} require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK
+     * implementations. Data encoding is an application-specific choice. These deprecated APIs will be removed in the
+     * future.
      */
     @Deprecated
     @SuppressWarnings("unchecked")
@@ -442,9 +443,10 @@ public <K extends MasterKey<K>> CryptoResult<String, K> decryptString(
      *
      * @see #decryptData(CryptoMaterialsManager, byte[])
      * @deprecated Use the {@link #decryptData(CryptoMaterialsManager, byte[])} and
-     * {@link #encryptData(CryptoMaterialsManager, byte[], Map)} APIs instead. {@code decryptString} is incompatible
-     * with the other AWS Encryption SDK language implementations. By design, this feature is not supported by the other
-     * language implementations.
+     * {@link #encryptData(CryptoMaterialsManager, byte[], Map)} APIs instead. {@code encryptString} and
+     * {@code decryptString} require an extra Base64 decode/encode step to interoperate with other AWS Encryption SDK
+     * implementations. Data encoding is an application-specific choice. These deprecated APIs will be removed in the
+     * future.
      */
     @Deprecated
     public CryptoResult<String, ?> decryptString(final CryptoMaterialsManager provider,