several edits and corrections to the manual