fixed limits and renamings in example.py
working on the documentation...
Merge branch 'penguin'