DOC: Improved bitwise_count documentation

ganesh-k13 · ganesh-k13 · commit 5928575f2f10 · 2023-03-18T11:56:05.000+05:30
* Added return type for integer inputs
* Refined release note
* Refined external references for popcount
diff --git a/doc/release/upcoming_changes/19355.new_feature.rst b/doc/release/upcoming_changes/19355.new_feature.rst
@@ -1,10 +1,9 @@
-`np.bitwise_count` to compute the number of 1-bits in an integer
-----------------------------------------------------------------
+`np.bitwise_count` to compute the number of 1-bits in an integer array
+----------------------------------------------------------------------
 
 This new function counts the number of 1-bits in a number.
-These work on all the numpy integer types, as well as the
-builtin arbitrary-precision `Decimal` and `long` types.
-Internally, this function calls `np.bit_count`
+`np.bitwise_count` works on all the numpy integer types and
+integer-like objects.
 
 .. code-block:: python
 
diff --git a/numpy/core/code_generators/ufunc_docstrings.py b/numpy/core/code_generators/ufunc_docstrings.py
@@ -4230,15 +4230,18 @@ def add_newdoc(place, name, doc):
     -------
     y : ndarray
         The corresponding number of 1-bits in the input.
+        Returns uint8 for all integer types
         $OUT_SCALAR_1
 
     References
     ----------
-    .. [1] https://stackoverflow.com/a/109025/5671364
+    .. [1] https://graphics.stanford.edu/~seander/bithacks.html#CountBitsSetParallel
 
     .. [2] Wikipedia, "Hamming weight",
            https://en.wikipedia.org/wiki/Hamming_weight
 
+    .. [3] http://aggregate.ee.engr.uky.edu/MAGIC/#Population%20Count%20(Ones%20Count)
+
     Examples
     --------
     >>> np.bitwise_count(1023)
