Fixed description of generateSessionKey (#1165)

src/openpgp.js

@@ -391,14 +391,11 @@ export function verify({ message, publicKeys, format = 'utf8', streaming = messa
 ///////////////////////////////////////////////
 
 /**
- * Decrypt symmetric session keys with a private key or password. Either a private key or
+ * Generate a new session key object, taking the algorithm preferences of the passed public keys into account.
- *   a password must be specified.
+ * @param  {Key|Array<Key>} publicKeys  array of public keys or single key used to select algorithm preferences for
- * @param  {Message} message                 a message object containing the encrypted session key packets
+ * @param  {Date} date                  (optional) date to select algorithm preferences at
- * @param  {Key|Array<Key>} privateKeys     (optional) private keys with decrypted secret key data
+ * @param  {Array} toUserIds            (optional) user IDs to select algorithm preferences for
- * @param  {String|Array<String>} passwords (optional) passwords to decrypt the session key
+ * @returns {Promise<{ data: Uint8Array, algorithm: String }>} object with session key data and algorithm
- * @returns {Promise<Object|undefined>}    Array of decrypted session key, algorithm pairs in form:
- *                                          { data:Uint8Array, algorithm:String }
- *                                          or 'undefined' if no key packets found
  * @async
  * @static
  */