Backport PR #55180 on branch 2.1.x (MAINT: Cleanup expired ndarray methods) (#55184)

Backport PR #55180: MAINT: Cleanup expired ndarray methods

Co-authored-by: Mateusz Sokół <[email protected]>

Author: meeseeksmachine

doc/source/user_guide/gotchas.rst

@@ -379,7 +379,7 @@ constructors using something similar to the following:
 .. ipython:: python
 
    x = np.array(list(range(10)), ">i4")  # big endian
-   newx = x.byteswap().newbyteorder()  # force native byteorder
+   newx = x.byteswap().view(x.dtype.newbyteorder())  # force native byteorder
    s = pd.Series(newx)
 
 See `the NumPy documentation on byte order

pandas/io/stata.py

@@ -1771,7 +1771,7 @@ def read(
             self._data_read = True
         # if necessary, swap the byte order to native here
         if self._byteorder != self._native_byteorder:
-            raw_data = raw_data.byteswap().newbyteorder()
+            raw_data = raw_data.byteswap().view(raw_data.dtype.newbyteorder())
 
         if convert_categoricals:
             self._read_value_labels()