Merge pull request #148 from burr86/master

Update and clarify function documentation