fix docblock
merged branch cordoval/patch-2 (PR #787)

This PR was submitted for the master branch but it was merged into the 1.0 branch instead (closes #787).

Discussion
----------

fix docblock

Commits
-------

fbf12a5 fix docblock