documentation tidy ups

The main change here is to replace the pre-compiled figures with ones generated
at documentation time.