cleaned things up a bit
committing some clarifications to python files