copy the first half of the Iris appendix into the repository, so that we can keep the documentation in sync
I planned to use them to simplify wsat_le, but it did not turn out to be simpler.