issue #7: docstrings for the numeric module