DOC: fixed broken links and added some cross-refs

seaborn/categorical.py

@@ -2219,7 +2219,7 @@ def plot(self, ax, boxplot_kws):
                 glyphs.\
     """),
     catplot=dedent("""\
-    catplot : Combine a categorical plot with a class:`FacetGrid`.\
+    catplot : Combine a categorical plot with a :class:`FacetGrid`.\
     """),
     boxenplot=dedent("""\
     boxenplot : An enhanced boxplot for larger datasets.\
@@ -2298,6 +2298,7 @@ def boxplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
     {violinplot}
     {stripplot}
     {swarmplot}
+    {catplot}
 
     Examples
     --------
@@ -2368,7 +2369,7 @@ def boxplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
         >>> ax = sns.boxplot(x="day", y="total_bill", data=tips)
         >>> ax = sns.swarmplot(x="day", y="total_bill", data=tips, color=".25")
 
-    Use :func:`catplot` to combine a :func:`pointplot` and a
+    Use :func:`catplot` to combine a :func:`boxplot` and a
     :class:`FacetGrid`. This allows grouping within additional categorical
     variables. Using :func:`catplot` is safer than using :class:`FacetGrid`
     directly, as it ensures synchronization of variable order across facets:
@@ -2476,6 +2477,7 @@ def violinplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
     {boxplot}
     {stripplot}
     {swarmplot}
+    {catplot}
 
     Examples
     --------
@@ -2696,6 +2698,7 @@ def boxenplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
     --------
     {violinplot}
     {boxplot}
+    {catplot}
 
     Examples
     --------
@@ -2842,6 +2845,9 @@ def stripplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
         of the points.
     {linewidth}
     {ax_in}
+    kwargs : key, value mappings
+        Other keyword arguments are passed through to ``plt.scatter`` at draw
+        time.
 
     Returns
     -------
@@ -2852,6 +2858,7 @@ def stripplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
     {swarmplot}
     {boxplot}
     {violinplot}
+    {catplot}
 
     Examples
     --------
@@ -3508,7 +3515,7 @@ def pointplot(x=None, y=None, hue=None, data=None, order=None, hue_order=None,
 
         >>> ax = sns.pointplot(x="day", y="tip", data=tips, capsize=.2)
 
-    Use :func:`catplot` to combine a :func:`barplot` and a
+    Use :func:`catplot` to combine a :func:`pointplot` and a
     :class:`FacetGrid`. This allows grouping within additional categorical
     variables. Using :func:`catplot` is safer than using :class:`FacetGrid`
     directly, as it ensures synchronization of variable order across facets:
@@ -3777,7 +3784,8 @@ def catplot(x=None, y=None, hue=None, data=None, row=None, col=None,
 
 
 catplot.__doc__ = dedent("""\
-    Figure-level interface for drawing categorical plots onto a FacetGrid.
+    Figure-level interface for drawing categorical plots onto a
+    :class:`FacetGrid`.
 
     This function provides access to several axes-level functions that
     show the relationship between a numerical and one or more categorical

seaborn/regression.py

@@ -1018,8 +1018,8 @@ def residplot(x, y, data=None, lowess=False, x_partial=None, y_partial=None,
     See Also
     --------
     regplot : Plot a simple linear regression model.
-    jointplot (with kind="resid"): Draw a residplot with univariate
-                                   marginal distrbutions.
+    jointplot : Draw a :func:`residplot` with univariate marginal distributions
+                (when used with ``kind="resid"``).
 
     """
     plotter = _RegressionPlotter(x, y, data, ci=None,