documenting raises, fixes #4