   # try
   #   my_mock.my_method()
   # catch error
-  #   console.log error               # prints "an error"
+  #   console.log error   # prints "an error"
   #
   throws: (error) ->
     @_check_throws_usage(error)

    

#
# mock() is a convenience function to ensure that .check() is called 
# on mock objects.  As such, it takes a function (the test code)
# argument, creates five mock objects, invokes the function with
# the five mocks, and then calls check() on those mocks.
#
mock = (fn) ->
  mocks = ( new Mock() for i in [1..5] )

#
# MethodSignature is an internal data structure that represents 
# a mocked method.  Stores the method name, the expected arguments,
# the value to return or throw, and whether it has actually been 
# called.  For example, the following:
#
#   my_mock = (new Mock).expects("my_method").args(1,2,3).returns(42)
