REF/DOC: privatize two functions, improve module docstring