OK, I'm happier with this docstring.  Review request before merge.