Plot shapefile documentation + shapefile changes

This documents how to your shapefile functionality in cartopy to plot them.
Builds on #179.  This pull request includes the changes from Phil (which includes documentation and some code changes)