Miscellaneous docs fixes
More fixes to doc formatting
Correct %edit docstring for ZMQ shell
Produce rst-compatible options lists from magic_arguments
Fix documentation of functions using magic_arguments
Use Sphinx autosummary extension for API docs index
Tidy up a few more warnings from Sphinx