Update docs for "apply" and add an example
Update README.md to new constructors
Merge pull request #1239 from zsxwing/apply-scaladoc-example

Update docs for "apply" and add an example