update docblock
update as per comments
Merge pull request #10 from cordoval/patch-2

[RFC] update docblock