revising examples; reordering sections
machine-generated version