updated read me and tweaked examples (maybe a bug fix?)