Extended example program and updated comments

* Added a multiline usage string example
* added comments to the exmaple program
* updated documentation comments in the header file