Improve gwpy.cli example handling in docs
This PR improves the handling/rendering of the gwpy.cli
examples as part of the documentation. I think the changes basically boil down to:
- only run the example if it has changed or the output doesn't exist yet
- resolve a couple of sphinx warnings