Clean one

This is the first release I am reasonably happy is correct, and which includes most of what I plan to add, and has a proper README (which though overlong at least includes most of what I need).