DOC: Added deprecation to convert_objects docstring#12052

Added deprecation warning to convert_objects docstring   Closes pandas-dev#12052

Author: MattRijk <[email protected]>

Closes pandas-dev#12209 from MattRijk/doc-12052 and squashes the following commits:

5be5d7a [MattRijk] Changed See also to correct format
8ff0da0 [MattRijk] Added See also section to convert_objects docs.
a10997d [MattRijk] DOC: Added deprecation to convert_objects docstring#12052

Author: MattRijk

pandas/core/generic.py

@@ -2034,7 +2034,7 @@ def _reindex_multi(self, axes, copy, fill_value):
         --------
         >>> df.reindex_axis(['A', 'B', 'C'], axis=1)
 
-        See also
+        See Also
         --------
         reindex, reindex_like
 
@@ -2740,6 +2740,8 @@ def _convert(self, datetime=False, numeric=False, timedelta=False,
     def convert_objects(self, convert_dates=True, convert_numeric=False,
                         convert_timedeltas=True, copy=True):
         """
+        Deprecated.
+
         Attempt to infer better dtype for object columns
 
         Parameters
@@ -2758,6 +2760,13 @@ def convert_objects(self, convert_dates=True, convert_numeric=False,
             conversion was done). Note: This is meant for internal use, and
             should not be confused with inplace.
 
+        See Also
+        --------
+        pandas.to_datetime : Convert argument to datetime.
+        pandas.to_timedelta : Convert argument to timedelta.
+        pandas.to_numeric : Return a fixed frequency timedelta index,
+            with day as the default.
+
         Returns
         -------
         converted : same as input object
@@ -2808,7 +2817,7 @@ def convert_objects(self, convert_dates=True, convert_numeric=False,
             or the string 'infer' which will try to downcast to an appropriate
             equal type (e.g. float64 to int64 if possible)
 
-        See also
+        See Also
         --------
         reindex, asfreq
 
@@ -2988,7 +2997,7 @@ def replace(self, to_replace=None, value=None, inplace=False, limit=None,
             The method to use when for replacement, when ``to_replace`` is a
             ``list``.
 
-        See also
+        See Also
         --------
         NDFrame.reindex
         NDFrame.asfreq
@@ -3299,7 +3308,7 @@ def isnull(self):
         """
         Return a boolean same-sized object indicating if the values are null.
 
-        See also
+        See Also
         --------
         notnull : boolean inverse of isnull
         """
@@ -3309,7 +3318,7 @@ def notnull(self):
         """Return a boolean same-sized object indicating if the values are
         not null.
 
-        See also
+        See Also
         --------
         isnull : boolean inverse of notnull
         """
@@ -3387,7 +3396,7 @@ def clip_upper(self, threshold, axis=None):
         axis : int or string axis name, optional
             Align object with threshold along the given axis.
 
-        See also
+        See Also
         --------
         clip
 
@@ -3411,7 +3420,7 @@ def clip_lower(self, threshold, axis=None):
         axis : int or string axis name, optional
             Align object with threshold along the given axis.
 
-        See also
+        See Also
         --------
         clip
 
@@ -4571,7 +4580,7 @@ def abs(self):
 
         The include, exclude arguments are ignored for Series.
 
-        See also
+        See Also
         --------
         DataFrame.select_dtypes
         """