Merge pull request matplotlib#15067 from QuLogic/fix-xref-whats-new-1

Fix cross-references in API changes < 1.0

Author: timhoffm

doc/api/prev_api_changes/api_changes_0.91.0.rst

@@ -2,20 +2,19 @@
 Changes for 0.91.0
 ==================
 
-* Changed :func:`cbook.is_file_like` to
-  :func:`cbook.is_writable_file_like` and corrected behavior.
+* Changed ``cbook.is_file_like`` to ``cbook.is_writable_file_like`` and
+  corrected behavior.
 
-* Added ax kwarg to :func:`pyplot.colorbar` and
-  :meth:`Figure.colorbar` so that one can specify the axes object from
+* Added *ax* keyword argument to :func:`.pyplot.colorbar` and
+  :meth:`.Figure.colorbar` so that one can specify the axes object from
   which space for the colorbar is to be taken, if one does not want to
   make the colorbar axes manually.
 
-* Changed :func:`cbook.reversed` so it yields a tuple rather than a
-  (index, tuple). This agrees with the python reversed builtin,
-  and cbook only defines reversed if python doesn't provide the
-  builtin.
+* Changed ``cbook.reversed`` so it yields a tuple rather than a (index, tuple).
+  This agrees with the Python reversed builtin, and cbook only defines reversed
+  if Python doesn't provide the builtin.
 
-* Made skiprows=1 the default on :func:`csv2rec`
+* Made skiprows=1 the default on ``csv2rec``
 
 * The gd and paint backends have been deleted.
 
@@ -32,17 +31,18 @@ Changes for 0.91.0
   files. In the future the class might actually parse the font to
   allow e.g.,  subsetting.
 
-* :mod:`matplotlib.FT2Font` now supports :meth:`FT_Attach_File`. In
+* :mod:`matplotlib.ft2font` now supports ``FT_Attach_File``. In
   practice this can be used to read an afm file in addition to a
   pfa/pfb file, to get metrics and kerning information for a Type 1
   font.
 
-* The :class:`AFM` class now supports querying CapHeight and stem
+* The :class:`.AFM` class now supports querying CapHeight and stem
   widths. The get_name_char method now has an isord kwarg like
   get_width_char.
 
-* Changed :func:`pcolor` default to shading='flat'; but as noted now in the
-  docstring, it is preferable to simply use the edgecolor kwarg.
+* Changed :func:`.pcolor` default to ``shading='flat'``; but as noted now in
+  the docstring, it is preferable to simply use the *edgecolor* keyword
+  argument.
 
 * The mathtext font commands (``\cal``, ``\rm``, ``\it``, ``\tt``) now
   behave as TeX does: they are in effect until the next font change
@@ -57,8 +57,7 @@ Changes for 0.91.0
   extent of a line of ordinary text.  The default is 1.2;
   ``linespacing=2`` would be like ordinary double spacing, for example.
 
-* Changed default kwarg in
-  :meth:`matplotlib.colors.Normalize.__init__`` to ``clip=False``;
+* Changed default kwarg in `matplotlib.colors.Normalize` to ``clip=False``;
   clipping silently defeats the purpose of the special over, under,
   and bad values in the colormap, thereby leading to unexpected
   behavior.  The new default should reduce such surprises.

doc/api/prev_api_changes/api_changes_0.91.2.rst

@@ -2,15 +2,15 @@
 Changes for 0.91.2
 ==================
 
-* For :func:`csv2rec`, checkrows=0 is the new default indicating all rows
+* For ``csv2rec``, checkrows=0 is the new default indicating all rows
   will be checked for type inference
 
 * A warning is issued when an image is drawn on log-scaled axes, since
   it will not log-scale the image data.
 
-* Moved :func:`rec2gtk` to :mod:`matplotlib.toolkits.gtktools`
+* Moved ``rec2gtk`` to ``matplotlib.toolkits.gtktools``
 
-* Moved :func:`rec2excel` to :mod:`matplotlib.toolkits.exceltools`
+* Moved ``rec2excel`` to ``matplotlib.toolkits.exceltools``
 
 * Removed, dead/experimental ExampleInfo, Namespace and Importer
-  code from :mod:`matplotlib.__init__`
+  code from :mod:`matplotlib`

doc/api/prev_api_changes/api_changes_0.98.0.rst

@@ -1,5 +1,5 @@
 Changes for 0.98.1
 ==================
 
-* Removed broken :mod:`matplotlib.axes3d` support and replaced it with
-  a non-implemented error pointing to 0.91.x
+* Removed broken ``matplotlib.axes3d`` support and replaced it with a
+  non-implemented error pointing to 0.91.x

doc/api/prev_api_changes/api_changes_0.98.1.rst

@@ -1,10 +1,10 @@
 
 Changes for 0.98.x
 ==================
-* psd(), csd(), and cohere() will now automatically wrap negative
+* ``psd()``, ``csd()``, and ``cohere()`` will now automatically wrap negative
   frequency components to the beginning of the returned arrays.
   This is much more sensible behavior and makes them consistent
-  with specgram().  The previous behavior was more of an oversight
+  with ``specgram()``.  The previous behavior was more of an oversight
   than a design decision.
 
 * Added new keyword parameters *nonposx*, *nonposy* to
@@ -15,7 +15,7 @@ Changes for 0.98.x
 
 * Added new :func:`matplotlib.pyplot.fignum_exists` and
   :func:`matplotlib.pyplot.get_fignums`; they merely expose
-  information that had been hidden in :mod:`matplotlib._pylab_helpers`.
+  information that had been hidden in ``matplotlib._pylab_helpers``.
 
 * Deprecated numerix package.
 
@@ -28,7 +28,7 @@ Changes for 0.98.x
 * Changed the defaults of acorr and xcorr to use usevlines=True,
   maxlags=10 and normed=True since these are the best defaults
 
-* Following keyword parameters for :class:`matplotlib.label.Label` are now
+* Following keyword parameters for :class:`matplotlib.legend.Legend` are now
   deprecated and new set of parameters are introduced. The new parameters
   are given as a fraction of the font-size. Also, *scatteryoffsets*,
   *fancybox* and *columnspacing* are added as keyword parameters.
@@ -61,7 +61,7 @@ Changes for 0.98.x
 
 * :meth:`matplotlib.axes.Axes.set_xlim`,
   :meth:`matplotlib.axes.Axes.set_ylim` now return a copy of the
-  :attr:`viewlim` array to avoid modify-in-place surprises.
+  ``viewlim`` array to avoid modify-in-place surprises.
 
 * :meth:`matplotlib.afm.AFM.get_fullname` and
   :meth:`matplotlib.afm.AFM.get_familyname` no longer raise an
@@ -86,13 +86,13 @@ Changes for 0.98.x
   :meth:`matplotlib.collections.Collection.set_offsets` added to
   :class:`~matplotlib.collections.Collection` base class.
 
-* :attr:`matplotlib.figure.Figure.figurePatch` renamed
+* ``matplotlib.figure.Figure.figurePatch`` renamed
   :attr:`matplotlib.figure.Figure.patch`;
-  :attr:`matplotlib.axes.Axes.axesPatch` renamed
+  ``matplotlib.axes.Axes.axesPatch`` renamed
   :attr:`matplotlib.axes.Axes.patch`;
-  :attr:`matplotlib.axes.Axes.axesFrame` renamed
+  ``matplotlib.axes.Axes.axesFrame`` renamed
   :attr:`matplotlib.axes.Axes.frame`.
-  :meth:`matplotlib.axes.Axes.get_frame`, which returns
+  ``matplotlib.axes.Axes.get_frame``, which returns
   :attr:`matplotlib.axes.Axes.patch`, is deprecated.
 
 * Changes in the :class:`matplotlib.contour.ContourLabeler` attributes
@@ -105,6 +105,6 @@ Changes for 0.98.x
 
 * Moved several functions in :mod:`matplotlib.mlab` and
   :mod:`matplotlib.cbook` into a separate module
-  :mod:`matplotlib.numerical_methods` because they were unrelated to
+  ``matplotlib.numerical_methods`` because they were unrelated to
   the initial purpose of mlab or cbook and appeared more coherent
   elsewhere.

doc/api/prev_api_changes/api_changes_0.98.x.rst

@@ -56,7 +56,7 @@ Changes beyond 0.99.x
 
 * There is a new rc parameter ``axes.color_cycle``, and the color
   cycle is now independent of the rc parameter ``lines.color``.
-  :func:`matplotlib.Axes.set_default_color_cycle` is deprecated.
+  ``matplotlib.Axes.set_default_color_cycle`` is deprecated.
 
 * You can now print several figures to one pdf file and modify the
   document information dictionary of a pdf file. See the docstrings

doc/api/prev_api_changes/api_changes_0.99.x.rst

@@ -46,7 +46,7 @@ original location:
   the upper and lower limits (*lolims*, *uplims*, *xlolims*, *xuplims*) now
   point in the correct direction.
 
-* The *fmt* kwarg for :func:`~matplotlib.pyplot.errorbar now supports
+* The *fmt* kwarg for :func:`~matplotlib.pyplot.errorbar` now supports
   the string 'none' to suppress drawing of a line and markers; use
   of the *None* object for this is deprecated. The default *fmt*
   value is changed to the empty string (''), so the line and markers
@@ -72,7 +72,7 @@ original location:
 * For consistency the ``face_alpha`` keyword to
   :class:`matplotlib.patheffects.SimplePatchShadow` has been deprecated in
   favour of the ``alpha`` keyword. Similarly, the keyword ``offset_xy`` is now
-  named ``offset`` across all :class:`~matplotlib.patheffects.AbstractPathEffect`s.
+  named ``offset`` across all :class:`~matplotlib.patheffects.AbstractPathEffect`\ s.
   ``matplotlib.patheffects._Base`` has
   been renamed to :class:`matplotlib.patheffects.AbstractPathEffect`.
   ``matplotlib.patheffect.ProxyRenderer`` has been renamed to

doc/api/prev_api_changes/api_changes_1.4.x.rst

@@ -865,8 +865,8 @@ future version.
 
 - `.projections.process_projection_requirements`
 
-- `.backend_ps.PsBackendHelper``
-- `.backend_ps.ps_backend_helper``,
+- ``backend_ps.PsBackendHelper``
+- ``backend_ps.ps_backend_helper``,
 
 - `.cbook.iterable`
 - `.cbook.get_label`
@@ -938,7 +938,8 @@ Axes3D
 - `.axes3d.Axes3D.w_yaxis`
 - `.axes3d.Axes3D.w_zaxis`
 
-Use `.axes3d.Axes3D.xaxis`, `.axes3d.Axes3D.and `.axes3d.Axes3D.zaxis` instead.
+Use `.axes3d.Axes3D.xaxis`, `.axes3d.Axes3D.yaxis` and `.axes3d.Axes3D.zaxis`
+instead.
 
 Testing
 ~~~~~~~
@@ -960,8 +961,8 @@ whereas calling ``set_facecolor`` does.
 GUI / backend details
 ~~~~~~~~~~~~~~~~~~~~~
 
-- `.get_py2exe_datafiles``
-- `.tk_window_focus``
+- ``.get_py2exe_datafiles``
+- ``.tk_window_focus``
 - `.backend_gtk3.FileChooserDialog`
 - `.backend_gtk3.NavigationToolbar2GTK3.get_filechooser`
 - `.backend_gtk3.SaveFigureGTK3.get_filechooser`