do some re-arrangement in pathsim.py

* move cli validation out of parse_args()
* doc fixes