Add javadoc

Author: vanitasvitae

pg/src/main/java/org/bouncycastle/openpgp/operator/PublicKeyKeyEncryptionMethodGenerator.java

@@ -192,18 +192,41 @@ public ContainedPacket generateV6(byte[] sessionInfo)
         return PublicKeyEncSessionPacket.createV6PKESKPacket(keyVersion, keyFingerprint, pubKey.getAlgorithm(), encodedEncSessionInfo);
     }
 
+    /**
+     * Encrypt a session key using the recipients public key.
+     * @param pubKey recipients public key
+     * @param fullSessionInfo full session info (sym-alg-id + session-key + 2 octet checksum)
+     * @param sessionInfoToEncrypt for v3: full session info; for v6: just the session-key
+     * @param optSymAlgId for v3: session key algorithm ID; for v6: empty array
+     * @return encrypted session info
+     * @throws PGPException
+     */
     protected abstract byte[] encryptSessionInfo(PGPPublicKey pubKey,
                                                  byte[] fullSessionInfo,
                                                  byte[] sessionInfoToEncrypt,
                                                  byte[] optSymAlgId)
         throws PGPException;
 
+    /**
+     * Encrypt a session key for a v3 PKESK.
+     * @param pubKey recipients public key
+     * @param sessionInfo session info (sym-alg-id + session-key + 2 octet checksum)
+     * @return encrypted session info
+     * @throws PGPException
+     */
     protected byte[] encryptSessionInfoV3(PGPPublicKey pubKey, byte[] sessionInfo)
         throws PGPException
     {
         return encryptSessionInfo(pubKey, sessionInfo, sessionInfo, new byte[]{sessionInfo[0]});
     }
 
+    /**
+     * Encrypt a session key for a v6 PKESK.
+     * @param pubKey recipients public key
+     * @param sessionInfo session info (sym-alg-id + session-key + 2 octet checksum)
+     * @return encrypted session info
+     * @throws PGPException
+     */
     protected byte[] encryptSessionInfoV6(PGPPublicKey pubKey, byte[] sessionInfo)
         throws PGPException
     {