add missing header comment and update doblocks
minor #91 add missing header comment and update doblocks (xabbuh)

This PR was merged into the 1.0-dev branch.

Discussion
----------

add missing header comment and update doblocks

Commits
-------

8868e2e add missing header comment and update doblocks