revised for doc string idiom consistency