Improve documentation (#1256)

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

* Document more APIs

* Upgrade Sphinx

* Belatedly bump version in docs

Author: akx

docs/api/dates.rst

@@ -40,8 +40,6 @@ Timezone Functionality
 
     A timezone object for the computer's local timezone.
 
-.. autoclass:: TimezoneTransition
-
 Data Access
 -----------
 
@@ -69,3 +67,9 @@ Basic Parsing
 .. autofunction:: parse_time
 
 .. autofunction:: parse_pattern
+
+Exceptions
+----------
+
+.. autoexception:: ParseError
+    :members:

docs/api/numbers.rst

@@ -36,19 +36,47 @@ Exceptions
 .. autoexception:: NumberFormatError
     :members:
 
+.. autoexception:: UnknownCurrencyError
+    :members:
+
+.. autoexception:: UnknownCurrencyFormatError
+    :members:
+
+.. autoexception:: UnsupportedNumberingSystemError
+    :members:
+
 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_precision
+
 .. 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

docs/api/plural.rst

@@ -21,3 +21,9 @@ Conversion Functionality
 .. autofunction:: to_python
 
 .. autofunction:: to_gettext
+
+Exceptions
+----------
+
+.. autoexception:: RuleError
+    :members:

docs/api/units.rst

@@ -11,3 +11,9 @@ locales.
 .. autofunction:: format_compound_unit
 
 .. autofunction:: get_unit_name
+
+Exceptions
+----------
+
+.. autoexception:: UnknownUnitError
+    :members:

docs/conf.py

@@ -44,16 +44,16 @@
 
 # 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.
-version = '2.17'
+version = '2.18'
 # 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.

docs/requirements.txt

@@ -1 +1 @@
-Sphinx~=5.3.0
+Sphinx~=9.1.0