text cleanup, fuller docblock. no code changes