Documentation for allow (#326 for 2.99)

Merge pull request #326 from rspec/feature_for_allow into 2.99
Documentation for allow (counterpart to stub in the expect syntax).