Improve documentation (#1256)

* Remove documentation link to TimezoneTransition (removed in #958)

* Document more APIs

* Upgrade Sphinx

* Belatedly bump version in docs

diff --git a/docs/api/dates.rst b/docs/api/dates.rst
index cbdac593b1c9730ace2fdc0687d08c0af085a396..9f0c80b574e6a598dfb1facaec0274566ed940e0 100644 (file)
--- a/docs/api/dates.rst
+++ b/docs/api/dates.rst
@@ -40,8 +40,6 @@ Timezone Functionality
 
     A timezone object for the computer's local timezone.
 
 
     A timezone object for the computer's local timezone.
 

-.. autoclass:: TimezoneTransition
-

 Data Access
 -----------
 
 Data Access
 -----------
 


@@ -69,3 +67,9 @@ Basic Parsing
 .. autofunction:: parse_time
 
 .. autofunction:: parse_pattern
 .. autofunction:: parse_time
 
 .. autofunction:: parse_pattern

+
+Exceptions
+----------
+
+.. autoexception:: ParseError
+    :members:

diff --git a/docs/api/numbers.rst b/docs/api/numbers.rst
index d3ab8b1166bc435c91a9bf58cd5f69fdf9b311df..c43bd56d2683cd4651c667e3d5bdd27e1d2bada8 100644 (file)
--- a/docs/api/numbers.rst
+++ b/docs/api/numbers.rst
@@ -36,19 +36,47 @@ Exceptions
 .. autoexception:: NumberFormatError
     :members:
 
 .. autoexception:: NumberFormatError
     :members:
 

+.. autoexception:: UnknownCurrencyError
+    :members:
+
+.. autoexception:: UnknownCurrencyFormatError
+    :members:
+
+.. autoexception:: UnsupportedNumberingSystemError
+    :members:
+

 Data Access
 -----------
 
 Data Access
 -----------
 

+.. autofunction:: get_decimal_symbol
+
+.. autofunction:: get_exponential_symbol
+
+.. autofunction:: get_group_symbol
+
+.. autofunction:: get_infinity_symbol
+
+.. autofunction:: get_minus_sign_symbol
+
+.. autofunction:: get_plus_sign_symbol
+
+Currency Utilities
+------------------
+

 .. autofunction:: get_currency_name
 
 .. autofunction:: get_currency_name
 

+.. autofunction:: get_currency_precision
+

 .. autofunction:: get_currency_symbol
 
 .. autofunction:: get_currency_unit_pattern
 
 .. autofunction:: get_currency_symbol
 
 .. autofunction:: get_currency_unit_pattern
 

-.. autofunction:: get_decimal_symbol
+.. autofunction:: get_territory_currencies

 
 

-.. autofunction:: get_plus_sign_symbol
+.. autofunction:: is_currency

 
 

-.. autofunction:: get_minus_sign_symbol
+.. autofunction:: list_currencies

 
 

-.. autofunction:: get_territory_currencies
+.. autofunction:: normalize_currency
+
+.. autofunction:: validate_currency

diff --git a/docs/api/plural.rst b/docs/api/plural.rst
index d6934b576cd18d85e64d372197478d4b735a640e..c40f29f04cc47705da83f87d904f3e4db78f7a51 100644 (file)
--- a/docs/api/plural.rst
+++ b/docs/api/plural.rst
@@ -21,3 +21,9 @@ Conversion Functionality
 .. autofunction:: to_python
 
 .. autofunction:: to_gettext
 .. autofunction:: to_python
 
 .. autofunction:: to_gettext

+
+Exceptions
+----------
+
+.. autoexception:: RuleError
+    :members:

diff --git a/docs/api/units.rst b/docs/api/units.rst
index 2b99be547325285c7fa84788258cfa1094853ff5..db94b7055178ed56d62da2b240443091bf5b6a7b 100644 (file)
--- a/docs/api/units.rst
+++ b/docs/api/units.rst
@@ -11,3 +11,9 @@ locales.
 .. autofunction:: format_compound_unit
 
 .. autofunction:: get_unit_name
 .. autofunction:: format_compound_unit
 
 .. autofunction:: get_unit_name

+
+Exceptions
+----------
+
+.. autoexception:: UnknownUnitError
+    :members:

diff --git a/docs/conf.py b/docs/conf.py
index b22b78c4f8565606d25aecccf81d8ba05199d5cf..eb817579678d4cd72a8cb00b54512a93d43a32ff 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -44,16 +44,16 @@ master_doc = 'index'
 
 # General information about the project.
 project = 'Babel'
 
 # General information about the project.
 project = 'Babel'

-copyright = '2025, The Babel Team'
+copyright = '2026, The Babel Team'

 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.

-version = '2.17'
+version = '2.18'

 # The full version, including alpha/beta/rc tags.
 # The full version, including alpha/beta/rc tags.

-release = '2.17.0'
+release = '2.18.0'

 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/docs/requirements.txt b/docs/requirements.txt
index c133306c70ffb973f6e31d61a56ba347c32a85e1..4864c69dde21341418ac9e245f47864114e0c27a 100644 (file)
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1 +1 @@
-Sphinx~=5.3.0
+Sphinx~=9.1.0