Improved the subplot function documentation and fixed the autogeneration
from boilerplate.
Merge pull request #1760 from pelson/subplot_doc

Improved the subplot function documentation and fixed the autogeneration from boilerplate.