   #         else
   #           console.log 'password incorrect!'
   #
-  # - `password`           _String_    The password to verify.
-  # - `hash`               _String_    The original bcrypt hash.
-  # - `callback(err, res)` _Function_  Called on completion or error.
-  # - `err`                _AuthError_ An AuthError wrapping any bcrypt error, or null.
-  # - `res`                _Boolean_   The verification result.
+  # @param [String]     password The password to verify.
+  # @param [String]     hash The original bcrypt hash.
+  # @param [Function]   callback(err, res) Called on completion or error.
+  # @param [AuthError]  err Wraps any bcrypt error; otherwise null.
+  # @param [Boolean]    res The verification result.
   @verifyPassword: (password, hash, callback) ->
 
     bcrypt.compare password, hash, (err, res) ->

  #
  #     auth = new Auth( argumenta )
  #
  constructor: (@argumenta, options) ->

  # Prototype
  # ---------

  # Verify login credentials `username` and `password` match a user account:
  #

  #       if not err                 # success
  #         typeof hash is 'string'  # true, it's the bcrypt hash
  #
  # @see Auth.bcryptCost
  # @param [String]    password The password to hash.
  # @param [Function]  callback(err, hash) Called on completion or error.
  # @param [AuthError] err Wraps any bcrypt error; otherwise null.
  # @param [String]    hash Passed to callback on success.
  @hashPassword: (password, callback) ->

    cost = Auth.bcryptCost
