Expand setup.py test/py.test options description (rebased onto develop)


This is the same as gh-875 but rebased onto develop.

----

- Use sphinx option markup for clarity/cross-referencing
- Put -h/--help at the top of the option list
- Add description for --markers option of setup.py test
- Add description for --repeat option of py.test

/cc @ximenesuk