fix return value parameter order

compare_* return values in the same order as the arguments. We messed
this up in several examples.
sphinx settings: print base classes and inherited members
minor documentation updates
fix ipython notebooks
update readme
update homepage
Merge pull request #23 from tjhei/update_readme

update readme and homepage
Merge pull request #22 from tjhei/ipython

fix ipython notebooks
Merge pull request #21 from tjhei/documentation_updates

sphinx documentation updates
Merge pull request #20 from tjhei/fix_chifactor_calls

fix return value parameter order