Improve docs, mention possible panics.
Merge pull request #166 from nwin/master

Improve docs, mention possible panics.