documentation update and utf-8 friendly for py2.7

Just a few tiny mods and my editor stripped trailing spaces. Blame on him :)