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.