improve python scripts to work with newer versions of Python (3)
improve python scripts and minor doc updates