diff --git a/java/common/org/linphone/core/LinphoneCallParams.java b/java/common/org/linphone/core/LinphoneCallParams.java
index c00a8cb34..c3bdc43ec 100644
--- a/java/common/org/linphone/core/LinphoneCallParams.java
+++ b/java/common/org/linphone/core/LinphoneCallParams.java
@@ -35,7 +35,15 @@ public interface LinphoneCallParams {
 	 */
 	void setAudioBandwidth(int value);
 	
+	/**
+	 * return selected media encryption
+	 * @return 'none', 'srtp' or 'zrtp'
+	 */
 	String getMediaEncryption();
+	/**
+	 * set media encryption (rtp) to use
+	 * @params menc: 'none', 'srtp' or 'zrtp'
+	 */
 	void setMediaEnctyption(String menc);
 	
 }
diff --git a/java/common/org/linphone/core/LinphoneCore.java b/java/common/org/linphone/core/LinphoneCore.java
index 42947a012..3e30414db 100644
--- a/java/common/org/linphone/core/LinphoneCore.java
+++ b/java/common/org/linphone/core/LinphoneCore.java
@@ -622,9 +622,23 @@ public interface LinphoneCore {
 
 	LinphoneCall findCallFromUri(String uri);
 	
+	/**
+	 * set media encryption (rtp) to use
+	 * @params menc: 'none', 'srtp' or 'zrtp'
+	 */
 	void setMediaEncryption(String menc);
+	/**
+	 * return selected media encryption
+	 * @return 'none', 'srtp' or 'zrtp'
+	 */
 	String getMediaEncryption();
 	
+	/**
+	 * Set media encryption required for outgoing calls
+	 */
 	void setMediaEncryptionMandatory(boolean yesno);
+	/**
+	 * @return if media encryption is required for ougtoing calls
+	 */
 	boolean isMediaEncryptionMandatory();
 }