documentation updates for 1.9

a bunch of documentation updates and a set of tests I had lying around in one of my local branches for the 1.9 branch
tuples of integers are actually still accepted, e.g. axis=(0,1), how to better formulate that?