updated in-script documentation