Fix formatting in from_global_dim_data docstring.

Sphinx doesn't like subsections under the main sections.
Fix a bad automodule reference.
Fix example formatting in plotting docstring.
Fix docstring formatting in make_grid_shape.
Fix return value formatting.
Fix formatting of other Raises section in format.py.