DOC: Fix docs issue

Author: mtsokol

doc/source/reference/routines.emath.rst

@@ -3,9 +3,37 @@
 Mathematical functions with automatic domain
 ********************************************
 
-.. currentmodule:: numpy
+.. currentmodule:: numpy.emath
 
-.. note:: :mod:`numpy.emath` is a preferred alias for ``numpy.lib.scimath``,
+.. note:: ``numpy.emath`` is a preferred alias for ``numpy.lib.scimath``,
           available after :mod:`numpy` is imported.
 
-.. automodule:: numpy.emath
+Wrapper functions to more user-friendly calling of certain math functions
+whose output data-type is different than the input data-type in certain
+domains of the input.
+
+For example, for functions like `log` with branch cuts, the versions in this
+module provide the mathematically valid answers in the complex plane::
+
+  >>> import math
+  >>> np.emath.log(-math.exp(1)) == (1+1j*math.pi)
+  True
+
+Similarly, `sqrt`, other base logarithms, `power` and trig functions
+are correctly handled.  See their respective docstrings for specific examples.
+
+Functions
+---------
+
+.. autosummary::
+   :toctree: generated/
+
+   arccos
+   arcsin
+   arctanh
+   log
+   log2
+   logn
+   log10
+   power
+   sqrt

numpy/_core/tests/test_umath.py

@@ -4019,14 +4019,15 @@ def test_array_ufunc_direct_call(self):
     def test_ufunc_docstring(self):
         original_doc = np.add.__doc__
         new_doc = "new docs"
+        expected_dict = {} if IS_PYPY else {"__module__": "numpy"}
 
         np.add.__doc__ = new_doc
         assert np.add.__doc__ == new_doc
         assert np.add.__dict__["__doc__"] == new_doc
 
         del np.add.__doc__
         assert np.add.__doc__ == original_doc
-        assert np.add.__dict__ == {"__module__": "numpy"}
+        assert np.add.__dict__ == expected_dict
 
         np.add.__dict__["other"] = 1
         np.add.__dict__["__doc__"] = new_doc
@@ -4035,7 +4036,7 @@ def test_ufunc_docstring(self):
         del np.add.__dict__["__doc__"]
         assert np.add.__doc__ == original_doc
         del np.add.__dict__["other"]
-        assert np.add.__dict__ == {"__module__": "numpy"}
+        assert np.add.__dict__ == expected_dict
 
 
 class TestChoose: