subplot docstring improvement (re #300)

I have tried to improve the documentation of the ```subplot``` function, I don't expect this to be perfect, but I do think its an improvement. 

This PR is in response to issue #300