comments in examples now match what examples actually do