diff --git a/lib/client.js b/lib/client.js
index 94b018ef8..8f36af911 100644
--- a/lib/client.js
+++ b/lib/client.js
@@ -1386,26 +1386,29 @@ function _PojoToMatrixEventMapper(plainOldJsObject) {
 // ==========================
 
 /**
- * @param {string} client_secret
  * @param {string} email
+ * @param {string} client_secret
  * @param {string} send_attempt
  * @param {module:client.callback} callback Optional.
  * @return {module:client.Promise} Resolves: TODO
  * @return {module:http-api.MatrixError} Rejects: with an error response.
  */
-MatrixClient.prototype.requestEmailToken = function(email, client_secret, send_attempt, callback) {
+MatrixClient.prototype.requestEmailToken = function(email, client_secret,
+                                                    send_attempt, callback) {
     var params = {
         client_secret: client_secret,
         email: email,
         send_attempt: send_attempt
     };
     return this._http.idServerRequest(
-        callback, "POST", "/validate/email/requestToken", params, httpApi.PREFIX_IDENTITY_V1
+        callback, "POST", "/validate/email/requestToken",
+        params, httpApi.PREFIX_IDENTITY_V1
     );
 };
 
 /**
  * Generates a random string suitable for use as a client secret
+ * @return {string} A new client secret
  */
 MatrixClient.prototype.generateClientSecret = function() {
     var ret = "";