Recapped an issue as a PR

fixed #694 Just listed out the other two ways to implement this as discussed in the issue.
Merge pull request #873 from signedbyte/patch-1

Recapped an issue as a PR.