Variety of minor fixes from the latest review, mostly comments and documentation.  Polished the example.