Document returned values

Fixes #1.