Fix outdated links and cleanup api docs

Author: lukelbd

WHATSNEW.rst

@@ -112,8 +112,8 @@ ProPlot v0.7.0 (2021-07-##)
 * When using ``medians=True`` or ``means=True`` with `indicate_error` plot simple
   error bars by default instead of bars and "boxes" (:commit:`4e30f415`). Only plot
   "boxes" with central "markers" by default for violin plots (:commit:`13b45ccd`).
-* `legend_wrapper` no longer returns the background patch generated for centered-row
-  legends (:pr:`254`). This is consistent with `colorbar_wrapper` not returning
+* `legend_extras` no longer returns the background patch generated for centered-row
+  legends (:pr:`254`). This is consistent with `colorbar_extras` not returning
   background patches generated for inset colorbars. Until proplot adds new subclasses,
   it makes more sense if these functions only return `~matplotlib.legend.Legend` and
   `~matplotlib.colorbar.Colorbar` instances.
@@ -129,8 +129,16 @@ ProPlot v0.7.0 (2021-07-##)
 * Add `wequal`, `hequal`, and `equal` options to still use automatic spacing but force
   the tight layout algorithm to make spacings equal (:pr:`215`, :issue:`64`)
   by `Zachary Moon`_.
-* Add baseline support for "3D" `~matplotlib.mpl_toolkits.mplot3d.Axes3D` axes
+* Add minimal support for "3D" `~matplotlib.mpl_toolkits.mplot3d.Axes3D` axes
   (:issue:`249`). Example usage: ``fig.subplots(proj='3d')``.
+* Add `~proplot.axes.Axes.plotx` and `~proplot.axes.Axes.scatterx` commands that
+  interpret plotting args as ``(y, x)`` rather than ``(x, y)``, analogous to
+  `~proplot.axes.Axes.areax` (:commit:`###`).
+* Add support for `~proplot.axes.indicate_error` *horizontal* error bars and
+  shading for line and scatter plots (:commit:`###`).
+* Add support for ``ax.plot_command('x_key', 'y_key', data=dataset)`` for
+  virtually all plotting commands using `standardize_1d` and `standardize_2d`
+  (:commit:`###`). This was an existing `~matplotlib.axes.Axes.plot` feature.
 * Allow updating axes fonts that use scalings like ``'small'`` and ``'large'``
   by passing ``fontsize=N`` to `format` (:issue:`212`).
 * Interpret fontsize-relative legend rc params like ``legend.borderpad``
@@ -184,6 +192,9 @@ ProPlot v0.7.0 (2021-07-##)
   ``'a'`` or ``'A'`` in string, and only replace that one (:issue:`201`).
 * Allow passing e.g. ``barstds=3`` or ``barpctiles=90`` to request error bars
   denoting +/-3 standard deviations and 5-95 percentile range (:commit:`4e30f415`).
+* Add singular `indicate_error` keywords `barstd`, `barpctile`, etc. as
+  alternatives to `barstds`, `barpctiles`, etc. (:commit:`81151a58`).
+  Also prefer them in the documentation.
 * Allow passing ``means=True`` to `boxplot` to toggle mean line
   (:commit:`4e30f415`).
 * Allow setting the mean and median boxplot linestyle with

docs/axis.py

@@ -31,7 +31,7 @@
 # --------------
 #
 # `Tick locators\
-# <https://matplotlib.org/3.2.1/gallery/ticks_and_spines/tick-locators.html>`__
+# <https://matplotlib.org/stable/gallery/ticks_and_spines/tick-locators.html>`__
 # are used to automatically select sensible tick locations
 # based on the axis data limits. In ProPlot, you can change the tick locator
 # using the `~proplot.axes.Axes.format` keyword arguments `xlocator`,
@@ -126,7 +126,7 @@
 # -----------
 #
 # `Tick formatters\
-# <https://matplotlib.org/3.2.1/gallery/ticks_and_spines/tick-formatters.html>`__
+# <https://matplotlib.org/stable/gallery/ticks_and_spines/tick-formatters.html>`__
 # are used to convert floating point numbers to
 # nicely-formatted tick labels. In ProPlot, you can change the tick formatter
 # using the `~proplot.axes.Axes.format` keyword arguments `xformatter` and
@@ -493,7 +493,7 @@
 # In the below examples, we generate dual axes with each of these three methods. Note
 # that the "parent" axis scale is now arbitrary -- in the first example shown below,
 # we create a `~proplot.axes.CartesianAxes.dualx` axis for an axis scaled by the
-# `symlog scale <https://matplotlib.org/3.1.0/gallery/scales/symlog_demo.html>`__.
+# `symlog scale <https://matplotlib.org/stable/gallery/scales/symlog_demo.html>`__.
 
 # %%
 import proplot as plot

docs/basics.py

@@ -153,7 +153,7 @@
 # --------------
 #
 # Matplotlib has
-# `two different interfaces <https://matplotlib.org/3.2.1/api/index.html>`__:
+# `two different interfaces <https://matplotlib.org/stable/api/index.html>`__:
 # an object-oriented interface and a MATLAB-style `~matplotlib.pyplot` interface
 # (which uses the object-oriented interface internally). Plotting with ProPlot is
 # just like plotting with matplotlib's *object-oriented* interface. Proplot builds
@@ -321,7 +321,7 @@
 # :ref:`ProPlot settings <rc_proplot>`. `~proplot.config.rc` also
 # provides a ``style`` parameter that can be used to switch between
 # `matplotlib stylesheets\
-# <https://matplotlib.org/3.1.1/gallery/style_sheets/style_sheets_reference.html>`__.
+# <https://matplotlib.org/stable/gallery/style_sheets/style_sheets_reference.html>`__.
 # See the :ref:`configuration section <ug_config>` for details.
 #
 # To modify a setting for just one subplot, you can pass it to the

docs/configuration.rst

@@ -98,7 +98,7 @@ The .proplotrc file
 
 When you install ProPlot for the first time, a ``.proplotrc`` file is generated
 and placed in your home directory. This is just like the `matplotlibrc file\
-<https://matplotlib.org/3.1.1/tutorials/introductory/customizing.html#customizing-with-matplotlibrc-files>`__,
+<https://matplotlib.org/stable/tutorials/introductory/customizing.html#customizing-with-matplotlibrc-files>`__,
 but for changing both ProPlot *and* matplotlib settings. The syntax is basically
 the same as the ``matplotlibrc`` syntax.
 

docs/cycles.py

@@ -26,7 +26,7 @@
 # instances so that they can be `used with categorical data\
 # <https://journals.ametsoc.org/view-large/figure/9538246/bams-d-13-00155_1-f5.tif>`__.
 # Much more commonly, we build `property cycles\
-# <https://matplotlib.org/3.1.0/tutorials/intermediate/color_cycle.html>`__
+# <https://matplotlib.org/stable/tutorials/intermediate/color_cycle.html>`__
 # from the `~proplot.colors.ListedColormap` colors using the
 # `~proplot.constructor.Cycle` constructor function or by
 # :ref:`drawing samples <ug_cycles_new>` from continuous colormaps.

docs/fonts.py

@@ -32,7 +32,7 @@
 #
 # Matplotlib provides a `~matplotlib.font_manager` module for working with
 # system fonts and classifies fonts into `five font families\
-# <https://matplotlib.org/3.1.1/gallery/text_labels_and_annotations/fonts_demo.html>`__:
+# <https://matplotlib.org/stable/gallery/text_labels_and_annotations/fonts_demo.html>`__:
 # :rcraw:`font.serif` :rcraw:`font.sans-serif`, :rcraw:`font.monospace`,
 # :rcraw:`font.cursive`, and :rcraw:`font.fantasy`. The default font family
 # is sans-serif, because sans-serif fonts are generally more suitable for

docs/insets_panels.py

@@ -115,7 +115,7 @@
 # ----------
 #
 # `Inset axes\
-# <https://matplotlib.org/3.1.1/gallery/subplots_axes_and_figures/zoom_inset_axes.html>`__
+# <https://matplotlib.org/stable/gallery/subplots_axes_and_figures/zoom_inset_axes.html>`__
 # can be generated with the `~proplot.axes.Axes.inset` or
 # `~proplot.axes.Axes.inset_axes` command. By default, inset axes
 # have the same projection as the parent axes, but you can also request

docs/projections.py

@@ -15,7 +15,7 @@
 
 # %% [raw] raw_mimetype="text/restructuredtext"
 #
-# .. _polar: https://matplotlib.org/3.1.0/gallery/pie_and_polar_charts/polar_demo.html
+# .. _polar: https://matplotlib.org/stable/gallery/pie_and_polar_charts/polar_demo.html
 #
 # .. _cartopy: https://scitools.org.uk/cartopy/docs/latest/
 #
@@ -241,7 +241,7 @@
 # `~mpl_toolkits.basemap.addcyclic`.
 #
 # Geographic features can be drawn underneath data or on top of data by changing the
-# corresponding `zorder <https://matplotlib.org/3.1.1/gallery/misc/zorder_demo.html>`__
+# corresponding `zorder <https://matplotlib.org/stable/gallery/misc/zorder_demo.html>`__
 # setting. For example, to draw land patches on top of all plotted content as
 # a "land mask," use ``ax.format(land=True, landzorder=4)`` or set :rcraw:`land.zorder`
 # to ``True``. See the :ref:`next section <ug_geoformat>` for details.

docs/subplots.py

@@ -63,7 +63,7 @@
 #      `nrows` arguments), the arguments `refaspect`, `refwidth`, and `refheight`
 #      apply to every subplot in the figure -- not just the reference subplot.
 #    * When the reference subplot `aspect ratio\
-#      <https://matplotlib.org/2.0.2/examples/pylab_examples/equal_aspect_ratio.html>`__
+#      <https://matplotlib.org/stable/examples/pylab_examples/equal_aspect_ratio.html>`__
 #      has been fixed (e.g., using ``ax.set_aspect(1)``) or is set to ``'equal'``
 #      (as with :ref:`geographic projections <ug_geo>` and
 #      `~matplotlib.axes.Axes.imshow` images), the fixed aspect ratio is used
@@ -157,7 +157,7 @@
 # subplot rows and columns and the figure edge to accommodate labels.
 # It can be disabled by passing ``tight=False`` to `~proplot.ui.subplots`.
 # While matplotlib has `its own tight layout algorithm
-# <https://matplotlib.org/3.1.1/tutorials/intermediate/tight_layout_guide.html>`__,
+# <https://matplotlib.org/stable/tutorials/intermediate/tight_layout_guide.html>`__,
 # ProPlot's algorithm may change the figure size to accommodate the correct spacing
 # and permits variable spacing between subsequent subplot rows and columns (see the
 # new `~proplot.gridspec.GridSpec` class for details).

docs/why.rst

@@ -142,11 +142,11 @@ seconds, typing out these extra class names and import statements can be a major
 
 Parts of matplotlib's interface were actually designed with this in mind.
 `Backend classes <https://matplotlib.org/faq/usage_faq.html#what-is-a-backend>`__,
-`native axes projections <https://matplotlib.org/3.1.1/api/projections_api.html>`__,
-`axis scales <https://matplotlib.org/3.1.0/gallery/scales/scales.html>`__,
-`box styles <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.FancyBboxPatch.html?highlight=boxstyle>`__,
-`arrow styles <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.FancyArrowPatch.html?highlight=arrowstyle>`__,
-and `arc styles <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.patches.ConnectionStyle.html?highlight=class%20name%20attrs>`__
+`native axes projections <https://matplotlib.org/stable/api/projections_api.html>`__,
+`axis scales <https://matplotlib.org/stable/gallery/scales/scales.html>`__,
+`box styles <https://matplotlib.org/stable/api/_as_gen/matplotlib.patches.FancyBboxPatch.html>`__,
+`arrow styles <https://matplotlib.org/stable/api/_as_gen/matplotlib.patches.FancyArrowPatch.html>`__,
+and `arc styles <https://matplotlib.org/stable/api/_as_gen/matplotlib.patches.ConnectionStyle.html>`__
 are referenced with "registered" string names,
 as are `basemap projections <https://matplotlib.org/basemap/users/mapsetup.html>`__.
 So, why not "register" everything else?
@@ -208,7 +208,7 @@ figure, despite the fact that...
    number of subplot tiles in the figure.
 
 Also, while matplotlib's `tight layout algorithm
-<https://matplotlib.org/tutorials/intermediate/tight_layout_guide.html>`__
+<https://matplotlib.org/stable/tutorials/intermediate/tight_layout_guide.html>`__
 helps to avoid tweaking the *spacing*, the algorithm cannot apply different amounts of
 spacing between different subplot row and column boundaries.
 
@@ -218,7 +218,7 @@ In ProPlot, you can specify the physical dimensions of a *reference subplot*
 instead of the figure by passing `refwidth`, `refheight`, and/or `refaspect` to
 `~proplot.figure.Figure`. The default behavior is ``refaspect=1`` and
 ``refwidth=2`` (inches). If the `aspect ratio mode
-<https://matplotlib.org/2.0.2/examples/pylab_examples/equal_aspect_ratio.html>`__
+<https://matplotlib.org/stable/gallery/subplots_axes_and_figures/axis_equal_demo.html>`__
 for the reference subplot is set to ``'equal'``, as with
 :ref:`geographic and polar <ug_proj>` plots and `~matplotlib.axes.Axes.imshow` plots,
 the *imposed* aspect ratio will be used instead.
@@ -331,7 +331,7 @@ difficult to draw "inset" colorbars in matplotlib.
 
 ..
    The matplotlib example for `~matplotlib.figure.Figure` legends is `not pretty
-   <https://matplotlib.org/3.1.1/gallery/text_labels_and_annotations/figlegend_demo.html>`__.
+   <https://matplotlib.org/stable/gallery/text_labels_and_annotations/figlegend_demo.html>`__.
 
 ..
    Drawing colorbars and legends is pretty clumsy in matplotlib -- especially