few "fashion" tweaks plus sphinx over epydoc docs
Merge pull request #421 from niphlod/fix/examples

few "fashion" tweaks plus sphinx over epydoc docs