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