remove spurious function from __all__
disable pylint message about too many args
fix and improve comment