fix a loop issue; update documentation; make mis-configured python a little more friendly.