fix docs and return the exit code from run_once()

fix docs and return the exit code from run_once() #20