fix flawed examples, include man rewrites