diff --git a/doc/conf.py b/doc/conf.py index 4f9c0f732027..7836b062fbd2 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -550,10 +550,6 @@ def js_tag_with_cache_busting(js): "cheatsheet_sidebar.html", "donate_sidebar.html", ], - # no sidebar for release notes, because that page is only a collection of links - # to sub-pages. The sidebar would repeat all the titles of the sub-pages and - # thus basically repeat all the content of the page. - "users/release_notes": ["empty_sidebar.html"], # '**': ['localtoc.html', 'pagesource.html'] } diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst index 5034bde1eefc..549db246463e 100644 --- a/doc/devel/release_guide.rst +++ b/doc/devel/release_guide.rst @@ -123,26 +123,12 @@ GitHub statistics We automatically extract GitHub issue, PRs, and authors from GitHub via the API. To prepare this list: -1. Archive the existing GitHub statistics page. - - a. Copy the current :file:`doc/users/github_stats.rst` to - :file:`doc/users/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`. - b. Change the link target at the top of the file. - c. Remove the "Previous GitHub Stats" section at the end. - - For example, when updating from v3.7.0 to v3.7.1:: - - cp doc/users/github_stats.rst doc/users/prev_whats_new/github_stats_3.7.0.rst - $EDITOR doc/users/prev_whats_new/github_stats_3.7.0.rst - # Change contents as noted above. - git add doc/users/prev_whats_new/github_stats_3.7.0.rst - -2. Re-generate the updated stats:: +1. Re-generate the stats, e.g., for version 3.7.1:: python tools/github_stats.py --since-tag v3.7.0 --milestone=v3.7.1 \ - --project 'matplotlib/matplotlib' --links > doc/users/github_stats.rst + --project 'matplotlib/matplotlib' --links > doc/users/prev_whats_new/github_stats_3.7.1.rst -3. Review and commit changes. Some issue/PR titles may not be valid reST (the most +2. Review and commit changes. Some issue/PR titles may not be valid reST (the most common issue is ``*`` which is interpreted as unclosed markup). .. note:: @@ -210,22 +196,22 @@ individual files. Release notes TOC ^^^^^^^^^^^^^^^^^ -Update :file:`doc/users/release_notes.rst`: - -- For macro and meso releases add a new section +- For macro and meso releases create a new :file:`doc/users/{X}.{Y}.rst` file, and + add it to the table of contents on :file:`doc/users/release_notes.rst`. .. code:: rst X.Y - === + ^^^ .. toctree:: :maxdepth: 1 prev_whats_new/whats_new_X.Y.0.rst ../api/prev_api_changes/api_changes_X.Y.0.rst prev_whats_new/github_stats_X.Y.0.rst + - For micro releases add the GitHub stats and (if present) the API changes to - the existing X.Y section + :file:`doc/users/{X}.{Y}.rst` .. code:: rst diff --git a/doc/users/0.x.rst b/doc/users/0.x.rst new file mode 100644 index 000000000000..f82d62c601d6 --- /dev/null +++ b/doc/users/0.x.rst @@ -0,0 +1,43 @@ +Pre version 1.0 +^^^^^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/changelog.rst + prev_whats_new/whats_new_0.99.rst + ../api/prev_api_changes/api_changes_0.99.x.rst + ../api/prev_api_changes/api_changes_0.99.rst + prev_whats_new/whats_new_0.98.4.rst + ../api/prev_api_changes/api_changes_0.98.x.rst + ../api/prev_api_changes/api_changes_0.98.1.rst + ../api/prev_api_changes/api_changes_0.98.0.rst + ../api/prev_api_changes/api_changes_0.91.2.rst + ../api/prev_api_changes/api_changes_0.91.0.rst + ../api/prev_api_changes/api_changes_0.90.1.rst + ../api/prev_api_changes/api_changes_0.90.0.rst + + ../api/prev_api_changes/api_changes_0.87.7.rst + ../api/prev_api_changes/api_changes_0.86.rst + ../api/prev_api_changes/api_changes_0.85.rst + ../api/prev_api_changes/api_changes_0.84.rst + ../api/prev_api_changes/api_changes_0.83.rst + ../api/prev_api_changes/api_changes_0.82.rst + ../api/prev_api_changes/api_changes_0.81.rst + ../api/prev_api_changes/api_changes_0.80.rst + + ../api/prev_api_changes/api_changes_0.73.rst + ../api/prev_api_changes/api_changes_0.72.rst + ../api/prev_api_changes/api_changes_0.71.rst + ../api/prev_api_changes/api_changes_0.70.rst + + ../api/prev_api_changes/api_changes_0.65.1.rst + ../api/prev_api_changes/api_changes_0.65.rst + ../api/prev_api_changes/api_changes_0.63.rst + ../api/prev_api_changes/api_changes_0.61.rst + ../api/prev_api_changes/api_changes_0.60.rst + + ../api/prev_api_changes/api_changes_0.54.3.rst + ../api/prev_api_changes/api_changes_0.54.rst + ../api/prev_api_changes/api_changes_0.50.rst + ../api/prev_api_changes/api_changes_0.42.rst + ../api/prev_api_changes/api_changes_0.40.rst diff --git a/doc/users/1.0.rst b/doc/users/1.0.rst new file mode 100644 index 000000000000..34a07ba3b83a --- /dev/null +++ b/doc/users/1.0.rst @@ -0,0 +1,6 @@ +Version 1.0 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.0.rst diff --git a/doc/users/1.1.rst b/doc/users/1.1.rst new file mode 100644 index 000000000000..d7c56a29d100 --- /dev/null +++ b/doc/users/1.1.rst @@ -0,0 +1,7 @@ +Version 1.1 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.1.rst + ../api/prev_api_changes/api_changes_1.1.x.rst diff --git a/doc/users/1.2.rst b/doc/users/1.2.rst new file mode 100644 index 000000000000..a91491793f70 --- /dev/null +++ b/doc/users/1.2.rst @@ -0,0 +1,8 @@ +Version 1.2 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.2.2.rst + prev_whats_new/whats_new_1.2.rst + ../api/prev_api_changes/api_changes_1.2.x.rst diff --git a/doc/users/1.3.rst b/doc/users/1.3.rst new file mode 100644 index 000000000000..97bef0a070d6 --- /dev/null +++ b/doc/users/1.3.rst @@ -0,0 +1,7 @@ +Version 1.3 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.3.rst + ../api/prev_api_changes/api_changes_1.3.x.rst diff --git a/doc/users/1.4.rst b/doc/users/1.4.rst new file mode 100644 index 000000000000..1b6a6b19de5c --- /dev/null +++ b/doc/users/1.4.rst @@ -0,0 +1,7 @@ +Version 1.4 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.4.rst + ../api/prev_api_changes/api_changes_1.4.x.rst diff --git a/doc/users/1.5.rst b/doc/users/1.5.rst new file mode 100644 index 000000000000..77617419fc58 --- /dev/null +++ b/doc/users/1.5.rst @@ -0,0 +1,9 @@ +Version 1.5 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_1.5.rst + ../api/prev_api_changes/api_changes_1.5.3.rst + ../api/prev_api_changes/api_changes_1.5.2.rst + ../api/prev_api_changes/api_changes_1.5.0.rst diff --git a/doc/users/2.0.rst b/doc/users/2.0.rst new file mode 100644 index 000000000000..0e117dae099f --- /dev/null +++ b/doc/users/2.0.rst @@ -0,0 +1,8 @@ +Version 2.0 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_2.0.0.rst + ../api/prev_api_changes/api_changes_2.0.1.rst + ../api/prev_api_changes/api_changes_2.0.0.rst diff --git a/doc/users/2.1.rst b/doc/users/2.1.rst new file mode 100644 index 000000000000..7791966beec4 --- /dev/null +++ b/doc/users/2.1.rst @@ -0,0 +1,9 @@ +Version 2.1 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_2.1.0.rst + ../api/prev_api_changes/api_changes_2.1.2.rst + ../api/prev_api_changes/api_changes_2.1.1.rst + ../api/prev_api_changes/api_changes_2.1.0.rst diff --git a/doc/users/2.2.rst b/doc/users/2.2.rst new file mode 100644 index 000000000000..dd089eee7ff9 --- /dev/null +++ b/doc/users/2.2.rst @@ -0,0 +1,7 @@ +Version 2.2 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_2.2.rst + ../api/prev_api_changes/api_changes_2.2.0.rst diff --git a/doc/users/3.0.rst b/doc/users/3.0.rst new file mode 100644 index 000000000000..f8159a49e98b --- /dev/null +++ b/doc/users/3.0.rst @@ -0,0 +1,12 @@ +Version 3.0 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.0.rst + ../api/prev_api_changes/api_changes_3.0.1.rst + ../api/prev_api_changes/api_changes_3.0.0.rst + prev_whats_new/github_stats_3.0.3.rst + prev_whats_new/github_stats_3.0.2.rst + prev_whats_new/github_stats_3.0.1.rst + prev_whats_new/github_stats_3.0.0.rst diff --git a/doc/users/3.1.rst b/doc/users/3.1.rst new file mode 100644 index 000000000000..445e74f98f91 --- /dev/null +++ b/doc/users/3.1.rst @@ -0,0 +1,12 @@ +Version 3.1 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.1.0.rst + ../api/prev_api_changes/api_changes_3.1.1.rst + ../api/prev_api_changes/api_changes_3.1.0.rst + prev_whats_new/github_stats_3.1.3.rst + prev_whats_new/github_stats_3.1.2.rst + prev_whats_new/github_stats_3.1.1.rst + prev_whats_new/github_stats_3.1.0.rst diff --git a/doc/users/3.2.rst b/doc/users/3.2.rst new file mode 100644 index 000000000000..12f56b6deb5b --- /dev/null +++ b/doc/users/3.2.rst @@ -0,0 +1,10 @@ +Version 3.2 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.2.0.rst + ../api/prev_api_changes/api_changes_3.2.0.rst + prev_whats_new/github_stats_3.2.2.rst + prev_whats_new/github_stats_3.2.1.rst + prev_whats_new/github_stats_3.2.0.rst diff --git a/doc/users/3.3.rst b/doc/users/3.3.rst new file mode 100644 index 000000000000..925065d90a31 --- /dev/null +++ b/doc/users/3.3.rst @@ -0,0 +1,13 @@ +Version 3.3 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.3.0.rst + ../api/prev_api_changes/api_changes_3.3.1.rst + ../api/prev_api_changes/api_changes_3.3.0.rst + prev_whats_new/github_stats_3.3.4.rst + prev_whats_new/github_stats_3.3.3.rst + prev_whats_new/github_stats_3.3.2.rst + prev_whats_new/github_stats_3.3.1.rst + prev_whats_new/github_stats_3.3.0.rst diff --git a/doc/users/3.4.rst b/doc/users/3.4.rst new file mode 100644 index 000000000000..1f410567d68d --- /dev/null +++ b/doc/users/3.4.rst @@ -0,0 +1,12 @@ +Version 3.4 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.4.0.rst + ../api/prev_api_changes/api_changes_3.4.2.rst + ../api/prev_api_changes/api_changes_3.4.0.rst + prev_whats_new/github_stats_3.4.3.rst + prev_whats_new/github_stats_3.4.2.rst + prev_whats_new/github_stats_3.4.1.rst + prev_whats_new/github_stats_3.4.0.rst diff --git a/doc/users/3.5.rst b/doc/users/3.5.rst new file mode 100644 index 000000000000..fb981df5c606 --- /dev/null +++ b/doc/users/3.5.rst @@ -0,0 +1,14 @@ +Version 3.5 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.5.2.rst + prev_whats_new/whats_new_3.5.0.rst + ../api/prev_api_changes/api_changes_3.5.3.rst + ../api/prev_api_changes/api_changes_3.5.2.rst + ../api/prev_api_changes/api_changes_3.5.0.rst + prev_whats_new/github_stats_3.5.3.rst + prev_whats_new/github_stats_3.5.2.rst + prev_whats_new/github_stats_3.5.1.rst + prev_whats_new/github_stats_3.5.0.rst diff --git a/doc/users/3.6.rst b/doc/users/3.6.rst new file mode 100644 index 000000000000..2963a58c76b2 --- /dev/null +++ b/doc/users/3.6.rst @@ -0,0 +1,12 @@ +Version 3.6 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.6.0.rst + ../api/prev_api_changes/api_changes_3.6.1.rst + ../api/prev_api_changes/api_changes_3.6.0.rst + prev_whats_new/github_stats_3.6.3.rst + prev_whats_new/github_stats_3.6.2.rst + prev_whats_new/github_stats_3.6.1.rst + prev_whats_new/github_stats_3.6.0.rst diff --git a/doc/users/3.7.rst b/doc/users/3.7.rst new file mode 100644 index 000000000000..338e21cf2fd2 --- /dev/null +++ b/doc/users/3.7.rst @@ -0,0 +1,11 @@ +Version 3.7 +^^^^^^^^^^^ +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.7.0.rst + ../api/prev_api_changes/api_changes_3.7.0.rst + prev_whats_new/github_stats_3.7.3.rst + prev_whats_new/github_stats_3.7.2.rst + prev_whats_new/github_stats_3.7.1.rst + prev_whats_new/github_stats_3.7.0.rst diff --git a/doc/users/3.8.rst b/doc/users/3.8.rst new file mode 100644 index 000000000000..202c29f81901 --- /dev/null +++ b/doc/users/3.8.rst @@ -0,0 +1,13 @@ +Version 3.8 +^^^^^^^^^^^ + +.. toctree:: + :maxdepth: 1 + + prev_whats_new/whats_new_3.8.0.rst + ../api/prev_api_changes/api_changes_3.8.1.rst + ../api/prev_api_changes/api_changes_3.8.0.rst + prev_whats_new/github_stats_3.8.3.rst + prev_whats_new/github_stats_3.8.2.rst + prev_whats_new/github_stats_3.8.1.rst + prev_whats_new/github_stats_3.8.0.rst diff --git a/doc/users/github_stats.rst b/doc/users/prev_whats_new/github_stats_3.8.3.rst similarity index 98% rename from doc/users/github_stats.rst rename to doc/users/prev_whats_new/github_stats_3.8.3.rst index 22226b89fa82..c91e046fd6ae 100644 --- a/doc/users/github_stats.rst +++ b/doc/users/prev_whats_new/github_stats_3.8.3.rst @@ -1,4 +1,4 @@ -.. _github-stats: +.. _github-stats-3-8-3: GitHub statistics for 3.8.3 (Feb 14, 2024) ========================================== @@ -137,14 +137,3 @@ Issues (18): * :ghissue:`27461`: [Doc]: API interface overview pylab incorrect import statement: from matplotlib.pyplot import * * :ghissue:`27383`: [Bug]: Error in Hexbin plot in Matplotlib 3.0 onward * :ghissue:`27358`: [Doc]: Garbled menu widget example output - - -Previous GitHub statistics --------------------------- - -.. toctree:: - :maxdepth: 1 - :glob: - :reversed: - - prev_whats_new/github_stats_* diff --git a/doc/users/prev_whats_new/whats_new_3.1.0.rst b/doc/users/prev_whats_new/whats_new_3.1.0.rst index 3d63768f9c7a..549b698051df 100644 --- a/doc/users/prev_whats_new/whats_new_3.1.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.1.0.rst @@ -4,7 +4,7 @@ What's new in Matplotlib 3.1 (May 18, 2019) =========================================== For a list of all of the issues and pull requests since the last -revision, see the :ref:`github-stats`. +revision, see the :ref:`github-stats-3-1-0`. .. contents:: Table of Contents :depth: 4 @@ -179,7 +179,7 @@ changed. Alternatively to strings like ``"data"`` or ``"axes fraction"``, `.ConnectionPatch` now accepts any `~matplotlib.transforms.Transform` as input for the *coordsA* and *coordsB* arguments. This allows to draw lines between -points defined in different user defined coordinate systems. Also see +points defined in different user defined coordinate systems. Also see :ref:`using_connectionpatch`. mplot3d Line3D now allows {set,get}_data_3d diff --git a/doc/users/prev_whats_new/whats_new_3.2.0.rst b/doc/users/prev_whats_new/whats_new_3.2.0.rst index 12d7fab3af90..936d64e74c76 100644 --- a/doc/users/prev_whats_new/whats_new_3.2.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.2.0.rst @@ -4,7 +4,7 @@ What's new in Matplotlib 3.2 (Mar 04, 2020) =========================================== For a list of all of the issues and pull requests since the last -revision, see the :ref:`github-stats`. +revision, see the :ref:`github-stats-3-2-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.3.0.rst b/doc/users/prev_whats_new/whats_new_3.3.0.rst index 00ea10620d14..c3ebc22fba9b 100644 --- a/doc/users/prev_whats_new/whats_new_3.3.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.3.0.rst @@ -5,7 +5,7 @@ What's new in Matplotlib 3.3.0 (Jul 16, 2020) ============================================= For a list of all of the issues and pull requests since the last -revision, see the :ref:`github-stats`. +revision, see the :ref:`github-stats-3-3-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.4.0.rst b/doc/users/prev_whats_new/whats_new_3.4.0.rst index 003cd85fa49d..806ad68c2e61 100644 --- a/doc/users/prev_whats_new/whats_new_3.4.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.4.0.rst @@ -5,7 +5,7 @@ What's new in Matplotlib 3.4.0 (Mar 26, 2021) ============================================= For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-4-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.5.0.rst b/doc/users/prev_whats_new/whats_new_3.5.0.rst index e67573702218..5135709616ba 100644 --- a/doc/users/prev_whats_new/whats_new_3.5.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.5.0.rst @@ -3,7 +3,7 @@ What's new in Matplotlib 3.5.0 (Nov 15, 2021) ============================================= For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-5-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.5.2.rst b/doc/users/prev_whats_new/whats_new_3.5.2.rst index 85b1c38862eb..19d60ec11977 100644 --- a/doc/users/prev_whats_new/whats_new_3.5.2.rst +++ b/doc/users/prev_whats_new/whats_new_3.5.2.rst @@ -3,7 +3,7 @@ What's new in Matplotlib 3.5.2 (May 02, 2022) ============================================= For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-5-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.6.0.rst b/doc/users/prev_whats_new/whats_new_3.6.0.rst index 859bbb47e354..031dc3b4680f 100644 --- a/doc/users/prev_whats_new/whats_new_3.6.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.6.0.rst @@ -3,7 +3,7 @@ What's new in Matplotlib 3.6.0 (Sep 15, 2022) ============================================= For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-6-0`. .. contents:: Table of Contents :depth: 4 @@ -168,7 +168,7 @@ The new *capwidths* parameter to `~.Axes.bxp` and `~.Axes.boxplot` allows controlling the widths of the caps in box and whisker plots. .. plot:: - :alt: A box plot with capwidths 0.01 and 0.2 + :alt: A box plot with capwidths 0.01 and 0.2 :include-source: true x = np.linspace(-7, 7, 140) @@ -302,7 +302,7 @@ within a single grid cell. See the difference between the plots below: .. plot:: :alt: A figure with two streamplots. First streamplot has broken streamlines. Second streamplot has continuous streamlines. - + w = 3 Y, X = np.mgrid[-w:w:100j, -w:w:100j] U = -1 - X**2 + Y @@ -326,7 +326,7 @@ the scale. This is based on an arcsinh transformation that allows plotting both positive and negative values that span many orders of magnitude. .. plot:: - :alt: Figure with 2 subplots. Subplot on the left uses symlog scale on the y axis. The transition at -2 is not smooth. Subplot on the right use asinh scale. The transition at -2 is smooth. + :alt: Figure with 2 subplots. Subplot on the left uses symlog scale on the y axis. The transition at -2 is not smooth. Subplot on the right use asinh scale. The transition at -2 is smooth. fig, (ax0, ax1) = plt.subplots(1, 2, sharex=True) x = np.linspace(-3, 6, 100) @@ -371,7 +371,7 @@ The rotation point of the `~matplotlib.patches.Rectangle` can now be set to 'xy', 'center' or a 2-tuple of numbers using the *rotation_point* argument. .. plot:: - :alt: Blue square that isn't rotated. Green square rotated 45 degrees relative to center. Orange square rotated 45 degrees relative to lower right corner. Red square rotated 45 degrees relative to point in upper right quadrant. + :alt: Blue square that isn't rotated. Green square rotated 45 degrees relative to center. Orange square rotated 45 degrees relative to lower right corner. Red square rotated 45 degrees relative to point in upper right quadrant. fig, ax = plt.subplots() @@ -448,7 +448,7 @@ It is now possible to set or get minor ticks using `.pyplot.xticks` and `.pyplot.yticks` by setting ``minor=True``. .. plot:: - :alt: Plot showing a line from 1,2 to 3.5,-0.5. X axis showing the 1, 2 and 3 minor ticks on the x axis as One, Zwei, Trois. + :alt: Plot showing a line from 1,2 to 3.5,-0.5. X axis showing the 1, 2 and 3 minor ticks on the x axis as One, Zwei, Trois. :include-source: true plt.figure() diff --git a/doc/users/prev_whats_new/whats_new_3.7.0.rst b/doc/users/prev_whats_new/whats_new_3.7.0.rst index 1834cbf3726f..bd11fc597181 100644 --- a/doc/users/prev_whats_new/whats_new_3.7.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.7.0.rst @@ -3,7 +3,7 @@ What's new in Matplotlib 3.7.0 (Feb 13, 2023) ============================================= For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-7-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/prev_whats_new/whats_new_3.8.0.rst b/doc/users/prev_whats_new/whats_new_3.8.0.rst index 8c34252098db..97678ec68b4a 100644 --- a/doc/users/prev_whats_new/whats_new_3.8.0.rst +++ b/doc/users/prev_whats_new/whats_new_3.8.0.rst @@ -3,7 +3,7 @@ What's new in Matplotlib 3.8.0 (Sept 13, 2023) ============================================== For a list of all of the issues and pull requests since the last revision, see -the :ref:`github-stats`. +the :ref:`github-stats-3-8-0`. .. contents:: Table of Contents :depth: 4 diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst index addfc08767e4..b4e96e23081f 100644 --- a/doc/users/release_notes.rst +++ b/doc/users/release_notes.rst @@ -13,238 +13,50 @@ Release notes .. include:: release_notes_next.rst -Version 3.8 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_3.8.0.rst - ../api/prev_api_changes/api_changes_3.8.1.rst - ../api/prev_api_changes/api_changes_3.8.0.rst - github_stats.rst - prev_whats_new/github_stats_3.8.2.rst - prev_whats_new/github_stats_3.8.1.rst - prev_whats_new/github_stats_3.8.0.rst - -Version 3.7 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_3.7.0.rst - ../api/prev_api_changes/api_changes_3.7.0.rst - prev_whats_new/github_stats_3.7.3.rst - prev_whats_new/github_stats_3.7.2.rst - prev_whats_new/github_stats_3.7.1.rst - prev_whats_new/github_stats_3.7.0.rst +Matplotlib 3.x +^^^^^^^^^^^^^^ -Version 3.6 -^^^^^^^^^^^ .. toctree:: :maxdepth: 1 - prev_whats_new/whats_new_3.6.0.rst - ../api/prev_api_changes/api_changes_3.6.1.rst - ../api/prev_api_changes/api_changes_3.6.0.rst - prev_whats_new/github_stats_3.6.3.rst - prev_whats_new/github_stats_3.6.2.rst - prev_whats_new/github_stats_3.6.1.rst - prev_whats_new/github_stats_3.6.0.rst + 3.8.rst + 3.7.rst + 3.6.rst + 3.5.rst + 3.4.rst + 3.3.rst + 3.2.rst + 3.1.rst + 3.0.rst -Version 3.5 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - prev_whats_new/whats_new_3.5.2.rst - prev_whats_new/whats_new_3.5.0.rst - ../api/prev_api_changes/api_changes_3.5.3.rst - ../api/prev_api_changes/api_changes_3.5.2.rst - ../api/prev_api_changes/api_changes_3.5.0.rst - prev_whats_new/github_stats_3.5.3.rst - prev_whats_new/github_stats_3.5.2.rst - prev_whats_new/github_stats_3.5.1.rst - prev_whats_new/github_stats_3.5.0.rst - -Version 3.4 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 +Matplotlib 2.x +^^^^^^^^^^^^^^ - prev_whats_new/whats_new_3.4.0.rst - ../api/prev_api_changes/api_changes_3.4.2.rst - ../api/prev_api_changes/api_changes_3.4.0.rst - prev_whats_new/github_stats_3.4.1.rst - prev_whats_new/github_stats_3.4.0.rst - -Version 3.3 -^^^^^^^^^^^ .. toctree:: :maxdepth: 1 - prev_whats_new/whats_new_3.3.0.rst - ../api/prev_api_changes/api_changes_3.3.1.rst - ../api/prev_api_changes/api_changes_3.3.0.rst - prev_whats_new/github_stats_3.3.4.rst - prev_whats_new/github_stats_3.3.3.rst - prev_whats_new/github_stats_3.3.2.rst - prev_whats_new/github_stats_3.3.1.rst - prev_whats_new/github_stats_3.3.0.rst - -Version 3.2 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 + 2.2.rst + 2.1.rst + 2.0.rst - prev_whats_new/whats_new_3.2.0.rst - ../api/prev_api_changes/api_changes_3.2.0.rst - prev_whats_new/github_stats_3.2.2.rst - prev_whats_new/github_stats_3.2.1.rst - prev_whats_new/github_stats_3.2.0.rst +Matplotlib 1.x +^^^^^^^^^^^^^^ -Version 3.1 -^^^^^^^^^^^ .. toctree:: :maxdepth: 1 - prev_whats_new/whats_new_3.1.0.rst - ../api/prev_api_changes/api_changes_3.1.1.rst - ../api/prev_api_changes/api_changes_3.1.0.rst - prev_whats_new/github_stats_3.1.3.rst - prev_whats_new/github_stats_3.1.2.rst - prev_whats_new/github_stats_3.1.1.rst - prev_whats_new/github_stats_3.1.0.rst - -Version 3.0 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_3.0.rst - ../api/prev_api_changes/api_changes_3.0.1.rst - ../api/prev_api_changes/api_changes_3.0.0.rst - prev_whats_new/github_stats_3.0.3.rst - prev_whats_new/github_stats_3.0.2.rst - prev_whats_new/github_stats_3.0.1.rst - prev_whats_new/github_stats_3.0.0.rst - -Version 2.2 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_2.2.rst - ../api/prev_api_changes/api_changes_2.2.0.rst - -Version 2.1 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_2.1.0.rst - ../api/prev_api_changes/api_changes_2.1.2.rst - ../api/prev_api_changes/api_changes_2.1.1.rst - ../api/prev_api_changes/api_changes_2.1.0.rst - -Version 2.0 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_2.0.0.rst - ../api/prev_api_changes/api_changes_2.0.1.rst - ../api/prev_api_changes/api_changes_2.0.0.rst - -Version 1.5 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_1.5.rst - ../api/prev_api_changes/api_changes_1.5.3.rst - ../api/prev_api_changes/api_changes_1.5.2.rst - ../api/prev_api_changes/api_changes_1.5.0.rst - -Version 1.4 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_1.4.rst - ../api/prev_api_changes/api_changes_1.4.x.rst - -Version 1.3 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_1.3.rst - ../api/prev_api_changes/api_changes_1.3.x.rst - -Version 1.2 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_1.2.2.rst - prev_whats_new/whats_new_1.2.rst - ../api/prev_api_changes/api_changes_1.2.x.rst - -Version 1.1 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 - - prev_whats_new/whats_new_1.1.rst - ../api/prev_api_changes/api_changes_1.1.x.rst - -Version 1.0 -^^^^^^^^^^^ -.. toctree:: - :maxdepth: 1 + 1.5.rst + 1.4.rst + 1.3.rst + 1.2.rst + 1.1.rst + 1.0.rst - prev_whats_new/whats_new_1.0.rst +Matplotlib 0.x +^^^^^^^^^^^^^^ -Version 0.x -^^^^^^^^^^^ .. toctree:: :maxdepth: 1 - prev_whats_new/changelog.rst - prev_whats_new/whats_new_0.99.rst - ../api/prev_api_changes/api_changes_0.99.x.rst - ../api/prev_api_changes/api_changes_0.99.rst - prev_whats_new/whats_new_0.98.4.rst - ../api/prev_api_changes/api_changes_0.98.x.rst - ../api/prev_api_changes/api_changes_0.98.1.rst - ../api/prev_api_changes/api_changes_0.98.0.rst - ../api/prev_api_changes/api_changes_0.91.2.rst - ../api/prev_api_changes/api_changes_0.91.0.rst - ../api/prev_api_changes/api_changes_0.90.1.rst - ../api/prev_api_changes/api_changes_0.90.0.rst - - ../api/prev_api_changes/api_changes_0.87.7.rst - ../api/prev_api_changes/api_changes_0.86.rst - ../api/prev_api_changes/api_changes_0.85.rst - ../api/prev_api_changes/api_changes_0.84.rst - ../api/prev_api_changes/api_changes_0.83.rst - ../api/prev_api_changes/api_changes_0.82.rst - ../api/prev_api_changes/api_changes_0.81.rst - ../api/prev_api_changes/api_changes_0.80.rst - - ../api/prev_api_changes/api_changes_0.73.rst - ../api/prev_api_changes/api_changes_0.72.rst - ../api/prev_api_changes/api_changes_0.71.rst - ../api/prev_api_changes/api_changes_0.70.rst - - ../api/prev_api_changes/api_changes_0.65.1.rst - ../api/prev_api_changes/api_changes_0.65.rst - ../api/prev_api_changes/api_changes_0.63.rst - ../api/prev_api_changes/api_changes_0.61.rst - ../api/prev_api_changes/api_changes_0.60.rst - - ../api/prev_api_changes/api_changes_0.54.3.rst - ../api/prev_api_changes/api_changes_0.54.rst - ../api/prev_api_changes/api_changes_0.50.rst - ../api/prev_api_changes/api_changes_0.42.rst - ../api/prev_api_changes/api_changes_0.40.rst + 0.x.rst diff --git a/doc/users/release_notes_next.rst b/doc/users/release_notes_next.rst index 6813f61c5f90..43674b4e4e8e 100644 --- a/doc/users/release_notes_next.rst +++ b/doc/users/release_notes_next.rst @@ -7,4 +7,3 @@ Next version next_whats_new ../api/next_api_changes - github_stats diff --git a/tools/github_stats.py b/tools/github_stats.py index af0255fcefba..35b2de90b8b9 100755 --- a/tools/github_stats.py +++ b/tools/github_stats.py @@ -28,7 +28,7 @@ PER_PAGE = 100 REPORT_TEMPLATE = """\ -.. _github-stats: +.. _github-stats-{tag_dash}: {title} {title_underline} @@ -270,10 +270,17 @@ def report(issues, show_urls=False): links = '' # Print summary report we can directly include into release notes. - print(REPORT_TEMPLATE.format(title=title, title_underline='=' * len(title), - since_day=since_day, tag=tag, - today=today.strftime('%Y/%m/%d'), - n_issues=n_issues, n_pulls=n_pulls, - milestone=milestone_str, - nauthors=len(unique_authors), ncommits=ncommits, - unique_authors='\n'.join(unique_authors), links=links)) + print(REPORT_TEMPLATE.format( + title=title, + title_underline='=' * len(title), + since_day=since_day, + tag=tag, + tag_dash=tag.replace(".", "-"), + today=today.strftime('%Y/%m/%d'), + n_issues=n_issues, + n_pulls=n_pulls, + milestone=milestone_str, + nauthors=len(unique_authors), + ncommits=ncommits, + unique_authors='\n'.join(unique_authors), + links=links))