run.sh bugfixes
documentation edits