Fixed a bunch of minor errors, fixed typos in the comments, removed mark...

...up not related to the sample code, general clarification...