docstring fixups

Author: jbrockmendel

pandas/_libs/tslibs/timedeltas.pyx

@@ -1309,7 +1309,7 @@ cdef class _Timedelta(timedelta):
         Examples
         --------
         >>> td = pd.Timedelta(42, input_unit='us')
-        >>> ts.unit
+        >>> td.unit
         'ns'
         """
         return npy_unit_to_abbrev(self._creso)
@@ -1966,6 +1966,10 @@ class Timedelta(_Timedelta):
 
             Allowing the values `w`, `d`, `MIN`, `MS`, `US` and `NS` to denote units
             are deprecated in favour of the values `W`, `D`, `min`, `ms`, `us` and `ns`.
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
 
     **kwargs
         Available kwargs: {days, seconds, microseconds,

pandas/_libs/tslibs/timestamps.pyx

@@ -1816,6 +1816,10 @@ class Timestamp(_Timestamp):
         when shifting from summer to winter time; fold describes whether the
         datetime-like corresponds  to the first (0) or the second time (1)
         the wall clock hits the ambiguous time.
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
 
     See Also
     --------

pandas/core/tools/datetimes.py

@@ -796,6 +796,10 @@ def to_datetime(
         is only used when there are at least 50 values. The presence of
         out-of-bounds values will render the cache unusable and may slow down
         parsing.
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
 
     Returns
     -------

pandas/core/tools/timedeltas.py

@@ -140,6 +140,10 @@ def to_timedelta(
     errors : {'raise', 'coerce'}, default 'raise'
         - If 'raise', then invalid parsing will raise an exception.
         - If 'coerce', then invalid parsing will be set as NaT.
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
 
     Returns
     -------