Documentation for allow (#326 for 2.14)

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