DOC: update the DataFrame.reindex_like docstring

pandas/core/frame.py

@@ -3842,6 +3842,12 @@ def set_index(self, keys, drop=True, append=False, inplace=False,
             necessary. Setting to False will improve the performance of this
             method
 
+        See Also
+        --------
+        DataFrame.reset_index : opposite of set_index
+        DataFrame.reindex : change to new indices or expand indices
+        DataFrame.reindex_like : change to same indices as other DataFrame
+
         Examples
         --------
         >>> df = pd.DataFrame({'month': [1, 4, 7, 10],
@@ -3981,6 +3987,12 @@ def reset_index(self, level=None, drop=False, inplace=False, col_level=0,
         -------
         resetted : DataFrame
 
+        See Also
+        --------
+        DataFrame.set_index : opposite of reset_index
+        DataFrame.reindex : change to new indices or expand indices
+        DataFrame.reindex_like : change to same indices as other DataFrame
+
         Examples
         --------
         >>> df = pd.DataFrame([('bird',    389.0),

pandas/core/generic.py

@@ -3331,12 +3331,18 @@ def select(self, crit, axis=0):
 
     def reindex_like(self, other, method=None, copy=True, limit=None,
                      tolerance=None):
-        """Return an object with matching indices to myself.
+        """
+        Return an object with matching indices as other object.
+
+        Conform the object to the same index on all axes. Optional
+        filling logic, placing NA/NaN in locations having no value
+        in the previous index. A new object is produced unless the
+        new index is equivalent to the current one and copy=False.
 
         Parameters
         ----------
         other : Object
-        method : string or None
+        method : {None, 'backfill'/'bfill', 'pad'/'ffill', 'nearest'}
         copy : boolean, default True
         limit : int, default None
             Maximum number of consecutive labels to fill for inexact matches.
@@ -3348,12 +3354,43 @@ def reindex_like(self, other, method=None, copy=True, limit=None,
 
         Notes
         -----
-        Like calling s.reindex(index=other.index, columns=other.columns,
-                               method=...)
+        Like calling `.reindex(index=other.index, columns=other.columns,
+                               method=...)`
 
         Returns
         -------
-        reindexed : same as input
+        Object
+            same object type as input, but with changed indices on each axis
+
+        See Also
+        --------
+        DataFrame.set_index : set row labels
+        DataFrame.reset_index : remove row labels or move them to new columns
+        DataFrame.reindex : change to new indices or expand indices
+
+        Examples
+        --------
+        >>> df_weather_station_1 = pd.DataFrame([[24.3, 75.7, 'high'],
+        ...                                      [31, 87.8, 'high'],
+        ...                                      [22, 71.6, 'medium'],
+        ...                                      [35, 95, 'medium']],
+        ...          columns=['temp_celsius', 'temp_fahrenheit', 'windspeed'],
+        ...          index=pd.date_range(start='2014-02-12',
+        ...                              end='2014-02-15', freq='D'))
+
+        >>> df_weather_station_2 = pd.DataFrame([[28, 'low'],
+        ...                                      [30, 'low'],
+        ...                                      [35.1, 'medium']],
+        ...          columns=['temp_celsius', 'windspeed'],
+        ...          index=pd.DatetimeIndex(['2014-02-12', '2014-02-13',
+        ...                                  '2014-02-15']))
+
+        >>> df_weather_station_2.reindex_like(df_weather_station_1)
+                    temp_celsius  temp_fahrenheit windspeed
+        2014-02-12          28.0              NaN       low
+        2014-02-13          30.0              NaN       low
+        2014-02-14           NaN              NaN       NaN
+        2014-02-15          35.1              NaN    medium
         """
         d = other._construct_axes_dict(axes=self._AXIS_ORDERS, method=method,
                                        copy=copy, limit=limit,
@@ -3769,6 +3806,12 @@ def sort_index(self, axis=0, level=None, ascending=True, inplace=False,
 
             .. versionadded:: 0.21.0 (list-like tolerance)
 
+        See Also
+        --------
+        DataFrame.set_index : set row labels
+        DataFrame.reset_index : remove row labels or move them to new columns
+        DataFrame.reindex_like : change to same indices as other DataFrame
+
         Examples
         --------
 
@@ -3994,11 +4037,10 @@ def _needs_reindex_multi(self, axes, method, level):
     def _reindex_multi(self, axes, copy, fill_value):
         return NotImplemented
 
-    _shared_docs[
-        'reindex_axis'] = ("""Conform input object to new index with optional
-        filling logic, placing NA/NaN in locations having no value in the
-        previous index. A new object is produced unless the new index is
-        equivalent to the current one and copy=False
+    _shared_docs['reindex_axis'] = ("""Conform input object to new index
+        with optional filling logic, placing NA/NaN in locations having
+        no value in the previous index. A new object is produced unless
+        the new index is equivalent to the current one and copy=False.
 
         Parameters
         ----------
@@ -4035,17 +4077,20 @@ def _reindex_multi(self, axes, copy, fill_value):
 
             .. versionadded:: 0.21.0 (list-like tolerance)
 
-        Examples
-        --------
-        >>> df.reindex_axis(['A', 'B', 'C'], axis=1)
-
         See Also
         --------
-        reindex, reindex_like
+        DataFrame.set_index : set row labels
+        DataFrame.reset_index : remove row labels or move them to new columns
+        DataFrame.reindex : change to new indices or expand indices
+        DataFrame.reindex_like : change to same indices as other DataFrame
 
         Returns
         -------
         reindexed : %(klass)s
+
+        Examples
+        --------
+        >>> df.reindex_axis(['A', 'B', 'C'], axis=1)
         """)
 
     @Appender(_shared_docs['reindex_axis'] % _shared_doc_kwargs)