Flesh out comments; move assumptions from function helptext to the README. (again)