Merge pull request #326 from rspec/feature_for_allow

Documentation for allow (counterpart to stub in the expect syntax)
Merge pull request #331 from rspec/feature_for_allow_299

Documentation for allow (#326 for 2.99)