Revise Authenticator#authorize docs.

Author: jaredhanson

lib/authenticator.js

@@ -188,14 +188,14 @@ Authenticator.prototype.authenticate = function(strategy, options, callback) {
  * be left unmodified.  A route handler can then link the third-party account to
  * the existing local account.
  *
- * Examples:
- *
- *    passport.authorize('twitter-authz', { failureRedirect: '/account' });
+ * All arguments to this function behave identically to those accepted by
+ * `{@link Authenticator#authenticate}`.
  *
- * @param {String} strategy
- * @param {Object} options
- * @return {Function} middleware
- * @api public
+ * @public
+ * @param {string|string[]|Strategy} strategy
+ * @param {Object} [options]
+ * @param {function} [callback]
+ * @returns {function}
  *
  * @example
  * app.get('/oauth/callback/twitter', passport.authorize('twitter'));