last bit of doc string fixing; clearly, this would usually all be done in a separate branch than master, then likely merge --squashed...