update the documentation for the BaseSystem

make some of the system class functions more transparent
Merge branch 'master' of github.com:pele-python/pele