updated API docs, tweaked run script