fixed discrepency between setup_script behaviour and docs, and clarified docstring