Add better comments for the example functions.  Fixes #17