#685 Add docs to PCRaster Python code and integrate this into manual

[Kor de Jong]

Instead of documenting the API by hand, the code should be documented and Sphinx should be used to pick these docs up and turn them into an API doc.

See also: http://sphinx-doc.org/man/sphinx-apidoc.html