Introducing main-docs-only option for automodapi

Introducing ``main-docs-only`` option for automodapi to be used in ``astropy.io.fits`` documentation.
It adds the main module's docstring and makes the module link which fixes the broken links of ``astropy.io.fits`` while keeping the current Reference/API structure without generating duplicate classes and functions lists.

Some pep8 changes was also made.