MAINT/DOC: Rework the *_roots functions and document them.
Merge pull request #3914 from ewmoore/roots_rewrite

Rework the *_roots functions and document them.