Updated the docs of pyplot.gca.
Merge pull request #2502 from pelson/gca_doc

Updated the docs of pyplot.gca.