From a8427d0fd921d1fbc1cdfe7399b5f8a8f5084684 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 3 Feb 2026 19:56:57 +0200
Subject: [PATCH 1/4] Remove documentation link to TimezoneTransition (removed
 in #958)

---
 docs/api/dates.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/api/dates.rst b/docs/api/dates.rst
index cbdac593b..13e7612ee 100644
--- 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.
 
-.. autoclass:: TimezoneTransition
-
 Data Access
 -----------
 

From 40c45f93b7c2fd9cfd8d751db16cb5bd3a620857 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 3 Feb 2026 19:57:31 +0200
Subject: [PATCH 2/4] Document more APIs

---
 docs/api/dates.rst   |  6 ++++++
 docs/api/numbers.rst | 36 ++++++++++++++++++++++++++++++++----
 docs/api/plural.rst  |  6 ++++++
 docs/api/units.rst   |  6 ++++++
 4 files changed, 50 insertions(+), 4 deletions(-)

diff --git a/docs/api/dates.rst b/docs/api/dates.rst
index 13e7612ee..9f0c80b57 100644
--- a/docs/api/dates.rst
+++ b/docs/api/dates.rst
@@ -67,3 +67,9 @@ Basic Parsing
 .. autofunction:: parse_time
 
 .. autofunction:: parse_pattern
+
+Exceptions
+----------
+
+.. autoexception:: ParseError
+    :members:
diff --git a/docs/api/numbers.rst b/docs/api/numbers.rst
index d3ab8b116..c43bd56d2 100644
--- a/docs/api/numbers.rst
+++ b/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
diff --git a/docs/api/plural.rst b/docs/api/plural.rst
index d6934b576..c40f29f04 100644
--- a/docs/api/plural.rst
+++ b/docs/api/plural.rst
@@ -21,3 +21,9 @@ Conversion Functionality
 .. autofunction:: to_python
 
 .. autofunction:: to_gettext
+
+Exceptions
+----------
+
+.. autoexception:: RuleError
+    :members:
diff --git a/docs/api/units.rst b/docs/api/units.rst
index 2b99be547..db94b7055 100644
--- a/docs/api/units.rst
+++ b/docs/api/units.rst
@@ -11,3 +11,9 @@ locales.
 .. autofunction:: format_compound_unit
 
 .. autofunction:: get_unit_name
+
+Exceptions
+----------
+
+.. autoexception:: UnknownUnitError
+    :members:

From a87a9670d15a958679ffe2ec65c4d628ba1a7686 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 3 Feb 2026 20:05:59 +0200
Subject: [PATCH 3/4] Upgrade Sphinx

---
 docs/requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index c133306c7..4864c69dd 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1 +1 @@
-Sphinx~=5.3.0
+Sphinx~=9.1.0

From 80f1912736b2158273782165cc529198d756d5eb Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 3 Feb 2026 20:07:39 +0200
Subject: [PATCH 4/4] Belatedly bump version in docs

---
 docs/conf.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index b22b78c4f..eb8175796 100644
--- a/docs/conf.py
+++ b/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.