Docstring for zonal_stats and its options

Documents zonal_stats options inline, for ease of exploring the module in, say, ipython.
I went with numpy docstring formatting, for its clarity in the code itself.