Updated Paice documentation (Sphinx-style) & improved demo.

Parameters for paice.py documented Sphinx-style; demo now uses more non-trivial example.