   # my_mock = new Mock()
   # expectation = my_mock.expects("my_method")
   # expectation.args(1,2,3)
+  # ...
   #
   # Or more usually:
   #

  # my_mock = new Mock()
  # expectation = my_mock.expects("my_method")
  # expectation.returns(42)
  #
  # Or more usually:
  #

# @expectations is just an array, not a hash.  It will not grow very large
# so a linear search for a particular expectation is fine.
#
# @expectations is added to the mock object by the various mock methods when 
# needed (i.e. lazily); if we mock an existing class then we only need to 
# worry about adding the mock methods to that class, not monkeying with its 
# contructor to also add @expectations.
#
class Mock

  #
  # my_mock = new Mock()
  # my_mock.expects("my_method")
  # my_mock.my_method()
  #
  expects: (method_name) ->
