Sphinx 8.2.0rc2__tar.gz → 8.2.2__tar.gz

sphinx-8.2.2/AUTHORS.rst

@@ -0,0 +1,130 @@
+Maintainers
+===========
+
+*Listed alphabetically in forename, surname order*
+
+* Adam Turner <@AA-Turner>
+* Bénédikt Tran <@picnixz>
+* Chris Sewell <@chrisjsewell>
+* François Freitag <@francoisfreitag>
+* Jakob Lykke Andersen <@jakobandersen>
+* Jean-François B. <@jfbu>
+* Stephen Finucane <@stephenfin>
+* Takayuki Shimizukawa <@shimizukawa>
+* Takeshi Komiya <@tk0miya>
+
+Contributors
+============
+
+*Listed alphabetically in forename, surname order*
+
+* Aaron Carlisle -- basic theme and templating improvements
+* Adam Dangoor -- improved static typing
+* Adrián Chaves (Gallaecio) -- coverage builder improvements
+* Alastair Houghton -- Apple Help builder
+* Alex Gaynor -- linkcheck retry on errors
+* Alexander Todorov -- inheritance_diagram tests and improvements
+* Andi Albrecht -- agogo theme
+* Antonio Valentino -- qthelp builder, docstring inheritance
+* Antti Kaihola -- doctest extension (skipif option)
+* Barry Warsaw -- setup command improvements
+* Bart Kamphorst -- warning improvements
+* Ben Egan -- Napoleon improvements & viewcode improvements
+* Benjamin Peterson -- unittests
+* Blaise Laflamme -- pyramid theme
+* Brecht Machiels -- builder entry-points
+* Bruce Mitchener -- Minor epub improvement
+* Buck Evan -- dummy builder
+* Charles Duffy -- original graphviz extension
+* Chris Barrick -- Napoleon type preprocessing logic
+* Chris Holdgraf -- improved documentation structure
+* Chris Lamb -- reproducibility fixes
+* Christopher Perkins -- autosummary integration
+* Dan MacKinlay -- metadata fixes
+* Daniel Bültmann -- todo extension
+* Daniel Eades -- improved static typing
+* Daniel Hahler -- testing and CI improvements
+* Daniel Pizetta -- inheritance diagram improvements
+* Dave Hoese -- ``sphinx.ext.viewcode`` and ``sphinx.ext.apidoc`` bug fixes
+* Dave Kuhlman -- original LaTeX writer
+* Dimitri Papadopoulos Orfanos -- linting and spelling
+* Dmitry Shachnev -- modernisation and reproducibility
+* Doug Hellmann -- graphviz improvements
+* Eric Larson -- better error messages
+* Eric N. Vander Weele -- autodoc improvements
+* Eric Wieser -- autodoc improvements
+* Etienne Desautels -- apidoc module
+* Ezio Melotti -- collapsible sidebar JavaScript
+* Filip Vavera -- napoleon todo directive
+* Glenn Matthews -- python domain signature improvements
+* Gregory Szorc -- performance improvements
+* Henrique Bastos -- SVG support for graphviz extension
+* Hernan Grecco -- search improvements
+* Hong Xu -- svg support in imgmath extension and various bug fixes
+* Horst Gutmann -- internationalization support
+* Hugo van Kemenade -- support FORCE_COLOR and NO_COLOR
+* Ian Lee -- quickstart improvements
+* Jacob Mason -- websupport library (GSOC project)
+* James Addison -- linkcheck and HTML search improvements
+* Jeppe Pihl -- literalinclude improvements
+* Jeremy Maitin-Shepard -- C++ domain improvements
+* Joel Wurtz -- cellspanning support in LaTeX
+* John Waltman -- Texinfo builder
+* Jon Dufresne -- modernisation
+* Josip Dzolonga -- coverage builder
+* Juan Luis Cano Rodríguez -- new tutorial (2021)
+* Julien Palard -- Colspan and rowspan in text builder
+* Justus Magin -- napoleon improvements
+* Kazuya Take -- ``sphinx.testing.path`` bug fix
+* Kevin Dunn -- MathJax extension
+* KINEBUCHI Tomohiko -- typing Sphinx as well as docutils
+* Kurt McKee -- documentation updates
+* Lars Hupfeldt Nielsen - OpenSSL FIPS mode md5 bug fix
+* Louis Maddox -- better docstrings
+* Łukasz Langa -- partial support for autodoc
+* Marco Buttu -- doctest extension (pyversion option)
+* Martin Hans -- autodoc improvements
+* Martin Larralde -- additional napoleon admonitions
+* Martin Liška -- option directive and role improvements
+* Martin Mahner -- nature theme
+* Matthew Fernandez -- todo extension fix
+* Matthew Woodcraft -- text output improvements
+* Matthias Geier -- style improvements
+* Michael Droettboom -- inheritance_diagram extension
+* Michael Wilson -- Intersphinx HTTP basic auth support
+* Nathan Damon -- bugfix in validation of static paths in html builders
+* Nils Kattenbeck -- pygments dark style
+* Pauli Virtanen -- autodoc improvements, autosummary extension
+* Rafael Fontenelle -- internationalisation
+* \A. Rafey Khan -- improved intersphinx typing
+* Roland Meister -- epub builder
+* Sebastian Wiesner -- image handling, distutils support
+* Slawek Figiel -- additional warning suppression
+* Stefan Seefeld -- toctree improvements
+* Stefan van der Walt -- autosummary extension
+* \T. Powers -- HTML output improvements
+* Taku Shimizu -- epub3 builder
+* Thomas Lamb -- linkcheck builder
+* Thomas Waldmann -- apidoc module fixes
+* Tim Hoffmann -- theme improvements
+* Vince Salvino -- JavaScript search improvements
+* Will Maier -- directory HTML builder
+* Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance
+
+Former maintainers
+==================
+
+*Listed alphabetically in forename, surname order*
+
+Former maintainers are those who haven't committed in the last two years.
+Those on the list below may become active maintainers again at any time.
+
+* Armin Ronacher <@mitsuhiko>
+* Daniel Neuhäuser <@DasIch>
+* Georg Brandl <georg@python.org>
+* Rob Ruana <@RobRuana>
+* Robert Lehmann <@lehmannro>
+* Timotheus Kampik <@TimKam>
+* Yoshiki Shibukawa <@shibukawa>
+
+Many thanks for all contributions!

sphinx-8.2.2/CHANGES.rst

@@ -0,0 +1,20 @@
+Release 8.3.0 (in development)
+==============================
+
+Dependencies
+------------
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+Testing
+-------

sphinx-8.2.2/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: Sphinx
+Version: 8.2.2
+Summary: Python documentation generator
+Author-email: Adam Turner <aa-turner@users.noreply.github.com>, Georg Brandl <georg@python.org>
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-Expression: BSD-2-Clause
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Other Audience
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Framework :: Sphinx
+Classifier: Framework :: Sphinx :: Domain
+Classifier: Framework :: Sphinx :: Extension
+Classifier: Framework :: Sphinx :: Theme
+Classifier: Topic :: Documentation
+Classifier: Topic :: Documentation :: Sphinx
+Classifier: Topic :: Education
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
+Classifier: Topic :: Printing
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Editors :: Documentation
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Text Processing :: General
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Text Processing :: Markup :: reStructuredText
+Classifier: Topic :: Text Processing :: Markup :: XML
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+License-File: LICENSE.rst
+Requires-Dist: sphinxcontrib-applehelp>=1.0.7
+Requires-Dist: sphinxcontrib-devhelp>=1.0.6
+Requires-Dist: sphinxcontrib-htmlhelp>=2.0.6
+Requires-Dist: sphinxcontrib-jsmath>=1.0.1
+Requires-Dist: sphinxcontrib-qthelp>=1.0.6
+Requires-Dist: sphinxcontrib-serializinghtml>=1.1.9
+Requires-Dist: Jinja2>=3.1
+Requires-Dist: Pygments>=2.17
+Requires-Dist: docutils>=0.20,<0.22
+Requires-Dist: snowballstemmer>=2.2
+Requires-Dist: babel>=2.13
+Requires-Dist: alabaster>=0.7.14
+Requires-Dist: imagesize>=1.3
+Requires-Dist: requests>=2.30.0
+Requires-Dist: roman-numerals-py>=1.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
+Requires-Dist: sphinxcontrib-websupport ; extra == "docs"
+Requires-Dist: ruff==0.9.9 ; extra == "lint"
+Requires-Dist: mypy==1.15.0 ; extra == "lint"
+Requires-Dist: sphinx-lint>=0.9 ; extra == "lint"
+Requires-Dist: types-colorama==0.4.15.20240311 ; extra == "lint"
+Requires-Dist: types-defusedxml==0.7.0.20240218 ; extra == "lint"
+Requires-Dist: types-docutils==0.21.0.20241128 ; extra == "lint"
+Requires-Dist: types-Pillow==10.2.0.20240822 ; extra == "lint"
+Requires-Dist: types-Pygments==2.19.0.20250219 ; extra == "lint"
+Requires-Dist: types-requests==2.32.0.20241016 ; extra == "lint"
+Requires-Dist: types-urllib3==1.26.25.14 ; extra == "lint"
+Requires-Dist: pyright==1.1.395 ; extra == "lint"
+Requires-Dist: pytest>=8.0 ; extra == "lint"
+Requires-Dist: pypi-attestations==0.0.21 ; extra == "lint"
+Requires-Dist: betterproto==2.0.0b6 ; extra == "lint"
+Requires-Dist: pytest>=8.0 ; extra == "test"
+Requires-Dist: pytest-xdist[psutil]>=3.4 ; extra == "test"
+Requires-Dist: defusedxml>=0.7.1 ; extra == "test"
+Requires-Dist: cython>=3.0 ; extra == "test"
+Requires-Dist: setuptools>=70.0 ; extra == "test"
+Requires-Dist: typing_extensions>=4.9 ; extra == "test"
+Project-URL: Changelog, https://www.sphinx-doc.org/en/master/changes.html
+Project-URL: Code, https://github.com/sphinx-doc/sphinx
+Project-URL: Documentation, https://www.sphinx-doc.org/
+Project-URL: Download, https://pypi.org/project/Sphinx/
+Project-URL: Homepage, https://www.sphinx-doc.org/
+Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues
+Provides-Extra: docs
+Provides-Extra: lint
+Provides-Extra: test
+
+========
+ Sphinx
+========
+
+.. image:: https://img.shields.io/pypi/v/sphinx.svg
+   :target: https://pypi.org/project/Sphinx/
+   :alt: Package on PyPI
+
+.. image:: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml
+   :alt: Build Status
+
+.. image:: https://readthedocs.org/projects/sphinx/badge/?version=master
+   :target: https://www.sphinx-doc.org/
+   :alt: Documentation Status
+
+.. image:: https://img.shields.io/badge/License-BSD%202--Clause-blue.svg
+   :target: https://opensource.org/licenses/BSD-2-Clause
+   :alt: BSD 2 Clause
+
+**Sphinx makes it easy to create intelligent and beautiful documentation.**
+
+Sphinx uses reStructuredText as its markup language, and many of its strengths
+come from the power and straightforwardness of reStructuredText and its parsing
+and translating suite, the Docutils.
+
+Features
+========
+
+* **Output formats**: HTML, PDF, plain text, EPUB, TeX, manual pages, and more
+* **Extensive cross-references**: semantic markup and automatic links
+  for functions, classes, glossary terms and similar pieces of information
+* **Hierarchical structure**: easy definition of a document tree, with automatic
+  links to siblings, parents and children
+* **Automatic indices**: general index as well as a module index
+* **Code highlighting**: automatic highlighting using the Pygments highlighter
+* **Templating**: Flexible HTML output using the Jinja 2 templating engine
+* **Extension ecosystem**: Many extensions are available, for example for
+  automatic function documentation or working with Jupyter notebooks.
+* **Language Support**: Python, C, C++, JavaScript, mathematics, and many other
+  languages through extensions.
+
+For more information, refer to `the documentation`_.
+
+Installation
+============
+
+The following command installs Sphinx from the `Python Package Index`_. You will
+need a working installation of Python and pip.
+
+.. code-block:: shell
+
+   pip install -U sphinx
+
+Contributing
+============
+
+We appreciate all contributions! Refer to `the contributors guide`_ for
+information.
+
+.. _the documentation: https://www.sphinx-doc.org/
+.. _the contributors guide: https://www.sphinx-doc.org/en/master/internals/contributing.html
+.. _Python Package Index: https://pypi.org/project/Sphinx/
+

sphinx-8.2.2/doc/changes/8.2.rst

@@ -0,0 +1,203 @@
+==========
+Sphinx 8.2
+==========
+
+
+Release 8.2.2 (released Mar 01, 2025)
+=====================================
+
+Bugs fixed
+----------
+
+* #13392: Fix argument type for ``jieba.load_userdict()``.
+* Add workaround for ``nbsphinx`` implicit imports.
+* #13402: Ensure inline ``<script/>`` tags are written exactly once.
+* #13391: apidoc: Fix TOC file not having a title.
+  Patch by Dave Hoese.
+
+Release 8.2.1 (released Feb 21, 2025)
+=====================================
+
+Bugs fixed
+----------
+
+* #13367: Correct spelling of ``highlighting_failure`` in warning sub-type.
+  Patch by Bart Kamphorst.
+* #13377: Restore support for using ``sphinx.testing.path`` paths with
+  ``sphinx.testing.fixtures``.
+  Patch by Kazuya Takei.
+* #13380: viewcode: Fix importing modules more than once.
+  Patch by Dave Hoese.
+* #13382: Napoleon: Use the right valid types for configuration values.
+  Patch by Adam Turner.
+* #13376: Fix copying assets from relative :confval:`html_static_path` and
+  :confval:`html_extra_path` entries.
+  Patch by Adam Turner.
+
+Release 8.2.0 (released Feb 18, 2025)
+=====================================
+
+Dependencies
+------------
+
+* #13000: Drop Python 3.10 support.
+
+Incompatible changes
+--------------------
+
+* #13044: Remove the internal and undocumented ``has_equations`` data
+  from the :py:class:`!MathDomain` domain.
+  The undocumented :py:meth:`!MathDomain.has_equations` method
+  now unconditionally returns ``True``.
+  These are replaced by the ``has_maths_elements`` key of the page context dict.
+  Patch by Adam Turner.
+* #13227: HTML output for sequences of keys in the :rst:role:`kbd` role
+  no longer uses a ``<kbd class="kbd compound">`` element to wrap
+  the keys and separators, but places them directly in the relevant parent node.
+  This means that CSS rulesets targeting ``kbd.compound`` or ``.kbd.compound``
+  will no longer have any effect.
+  Patch by Adam Turner.
+
+Deprecated
+----------
+
+* #13037: Deprecate the ``SingleHTMLBuilder.fix_refuris`` method.
+  Patch by James Addison.
+* #13083, #13330: Un-deprecate ``sphinx.util.import_object``.
+  Patch by Matthias Geier.
+
+Features added
+--------------
+
+* #13173: Add a new ``duplicate_declaration`` warning type,
+  with ``duplicate_declaration.c`` and ``duplicate_declaration.cpp`` subtypes.
+  Patch by Julien Lecomte and Adam Turner.
+* #11824: linkcode: Allow extensions to add support for a domain by defining
+  the keys that should be present.
+  Patch by Nicolas Peugnet.
+* #13144: Add a ``class`` option to the :rst:dir:`autosummary` directive.
+  Patch by Tim Hoffmann.
+* #13146: Napoleon: Unify the type preprocessing logic to allow
+  Google-style docstrings to use the optional and default keywords.
+  Patch by Chris Barrick.
+* #13227: Implement the :rst:role:`kbd` role as a ``SphinxRole``.
+  Patch by Adam Turner.
+* #13065: Enable colour by default in when running on CI.
+  Patch by Adam Turner.
+* #13230: Allow supressing warnings from the :rst:dir:`toctree` directive
+  when a glob pattern doesn't match any documents,
+  via the new ``toc.empty_glob`` warning sub-type.
+  Patch by Slawek Figiel.
+* #9732: Add the new ``autodoc.mocked_object`` warnings sub-type.
+  Patch by Cyril Roelandt.
+* #7630, #4824: autodoc: Use :file:`.pyi` type stub files
+  to auto-document native modules.
+  Patch by Adam Turner, partially based on work by Allie Fitter.
+* #12975: Enable configuration of trailing commas in multi-line signatures
+  in the Python and Javascript domains, via the new
+  :confval:`python_trailing_comma_in_multi_line_signatures` and
+  :confval:`javascript_trailing_comma_in_multi_line_signatures`
+  configuration options.
+* #13264: Rename the :rst:dir:`math` directive's ``nowrap`` option
+  to :rst:dir:`math:no-wrap`.
+  Patch by Adam Turner.
+* #13269: Added the option to disable the use of type comments in
+  via the new :confval:`autodoc_use_type_comments` option,
+  which defaults to ``True`` for backwards compatibility.
+  The default will change to ``False`` in Sphinx 10.
+  Patch by Adam Turner.
+* #9732: Add the new ``ref.any`` warnings sub-type
+  to allow suppressing the ambiguous 'any' cross-reference warning.
+  Patch by Simão Afonso and Adam Turner.
+* #13272: The Python and JavaScript module directives now support
+  the ``:no-index-entry:`` option.
+  Patch by Adam Turner.
+* #12233: autodoc: Allow directives to use ``:no-index-entry:``
+  and include the ``:no-index:`` and ``:no-index-entry:`` options within
+  :confval:`autodoc_default_options`.
+  Patch by Jonny Saunders and Adam Turner.
+* #13172: Add support for short signatures in autosummary.
+  Patch by Tim Hoffmann.
+* #13271: Change the signature prefix for abstract methods
+  in the Python domain to *abstractmethod* from *abstract*.
+  Patch by Adam Turner.
+* #13271: Support the ``:abstract:`` option for
+  classes, methods, and properties in the Python domain.
+  Patch by Adam Turner.
+* #12507: Add the :ref:`collapsible <collapsible-admonitions>` option
+  to admonition directives.
+  Patch by Chris Sewell.
+* #8191, #8159: Add :rst:dir:`inheritance-diagram:include-subclasses` option to
+  the :rst:dir:`inheritance-diagram` directive.
+  Patch by Walter Dörwald.
+* #11995: autodoc: Add support for :confval:`python_display_short_literal_types`.
+  Patch by Bénédikt Tran and Adam Turner.
+* #13163: Always print the full context when Sphinx encounters an internal error.
+  Patch by Kevin Deldycke and Adam Turner.
+* #13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator
+  functions and methods in the Python domain.
+  Patch by Adam Turner.
+* #9169: Add the :confval:`intersphinx_resolve_self` option
+  to resolve an intersphinx reference to the current project.
+  Patch by Jakob Lykke Andersen and Adam Turner.
+* #11280: Add ability to skip a particular section using the ``no-search`` class.
+  Patch by Will Lachance.
+* #13326: Remove hardcoding from handling :class:`~sphinx.addnodes.productionlist`
+  nodes in all writers, to improve flexibility.
+  Patch by Adam Turner.
+* #13335: Use ``misc.highlighting_failure`` subtype for Pygments unknown lexers.
+  Patch by Bart Kamphorst.
+* #13354: Insert abbreviation nodes (hover text) for positional- and keyword-only
+  separators in Python signatures.
+  Patch by Adam Turner.
+* #13333: Add the :mod:`sphinx.ext.apidoc` extension,
+  to automate API documentation generation from Python modules.
+  Patch by Chris Sewell and Adam Turner.
+
+Bugs fixed
+----------
+
+* #12463: autosummary: Respect an empty module ``__all__``.
+  Patch by Valentin Pratz
+* #13060: HTML Search: use ``Map`` to store per-file term scores.
+  Patch by James Addison
+* #13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries
+  in French.  See :confval:`latex_use_xindy`.
+  Patch by Jean-François B.
+* #13152: LaTeX: fix a typo from v7.4.0 in a default for ``\sphinxboxsetup``.
+  Patch by Jean-François B.
+* #13096: HTML Search: check that query terms exist as properties in
+  term indices before accessing them.
+* #11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` by
+  overriding session-level ``requests.get_redirect_target``.
+* #13195: viewcode: Fix issue where import paths differ from the directory
+  structure.
+  Patch by Ben Egan and Adam Turner.
+* #13188: autodoc: fix detection of class methods implemented in C.
+  Patch by Bénédikt Tran.
+* #1810: Always copy static files when building, regardless of whether
+  any documents have changed since the previous build.
+  Patch by Adam Turner.
+* #13201: autodoc: fix ordering of members when using ``groupwise``
+  for :confval:`autodoc_member_order`. Class methods are now rendered
+  before static methods, which themselves are rendered before regular
+  methods and attributes.
+  Patch by Bénédikt Tran.
+* #12975: Avoid rendering a trailing comma in C and C++ multi-line signatures.
+* #13178: autodoc: Fix resolution for ``pathlib`` types.
+  Patch by Adam Turner.
+* #13136: autodoc: Correctly handle multiple inheritance.
+  Patch by Pavel Holica
+* #13273, #13318: Properly convert command-line overrides for Boolean types.
+  Patch by Adam Turner.
+* #13302, #13319: Use the correct indentation for continuation lines
+  in :rst:dir:`productionlist` directives.
+  Patch by Adam Turner.
+* #13328: Fix parsing of PEP 695 functions with return annotations.
+  Patch by Bénédikt Tran. Initial work by Arash Badie-Modiri.
+
+Testing
+-------
+
+* #13224: Correctness fixup for ``test_html_multi_line_copyright``.
+  Patch by Colin Watson, applied by James Addison.

sphinx-8.2.2/doc/changes/index.rst

@@ -0,0 +1,73 @@
+.. _changes:
+
+=========
+Changelog
+=========
+
+.. raw:: latex
+
+   \addtocontents{toc}{\protect\setcounter{tocdepth}{1}}%
+   \makeatletter
+   \addtocontents{toc}%
+   {\def\string\l@section{\string\@dottedtocline{1}{1.5em}{3.3em}}}
+   \addtocontents{toc}%
+   {\def\string\l@subsection{\string\@dottedtocline{2}{4.8em}{4em}}}
+   \makeatother
+
+
+.. include:: ../../CHANGES.rst
+
+
+Prior releases
+==============
+
+.. toctree::
+   :maxdepth: 2
+
+   8.2
+   8.1
+   8.0
+   7.4
+   7.3
+   7.2
+   7.1
+   7.0
+   6.2
+   6.1
+   6.0
+   5.3
+   5.2
+   5.1
+   5.0
+   4.5
+   4.4
+   4.3
+   4.2
+   4.1
+   4.0
+   3.5
+   3.4
+   3.3
+   3.2
+   3.1
+   3.0
+   2.4
+   2.3
+   2.2
+   2.1
+   2.0
+   1.8
+   1.7
+   1.6
+   1.5
+   1.4
+   1.3
+   1.2
+   1.1
+   1.0
+   0.6
+   0.5
+   0.4
+   0.3
+   0.2
+   0.1