Add better comments for the example functions. Fixes #17