rspec/rspec-mocks — pull request #326 by JonRowe (2013-06-25 23:05:07+00:00)
Title: Documentation for allow (counterpart to stub in the expect syntax)

As `allow(obj).to receive(:message)` is the counterpart to `stub`, we should document it alongside as we have done with `expect(obj).to receive(:message)` as a counterpart to `should_receive`.