ENH #4163 - finalized tests and docs, ready for wider use…