Better documentation of run_script errors

In order to prevent headaches later, I have documented the reason behind
the catching of exit codes and rescues in the run_script function (soon
to be renamed to run_command)
Remove unnecessary variable interpolation