Update docs for apply, additional example and test case
Merge pull request #167 from LewisJEllis/apply-docs

Update docs for apply, additional example and test case