run.py update and small doc/style fixes