Add usage and installation to the README file

and update an example in a headerdoc comment.