add --format documentation to .rspec and tidy up some specs