Sphinx-style documentation for Paice

Sphinx-style documenation of parameters included;
demo has been updated to include more interesting example.