FLINK-828: incorporating comments

* fixed formatting and doc/comment issues
* added example data set (usable via "example" on the command line)