From: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Date: Fri, 25 Aug 2023 05:56:54 +0000 (+0100)
Subject: GH-108202: Document ``calendar`` exceptions (#108398)
X-Git-Tag: v3.13.0a1~782
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=135098743a0fae0efbcd98e35458e5bc721702e9;p=thirdparty%2FPython%2Fcpython.git

GH-108202: Document ``calendar`` exceptions (#108398)
---

diff --git a/Doc/library/calendar.rst b/Doc/library/calendar.rst
index 07d04a1c7b58..3c097f4cf7ab 100644
--- a/Doc/library/calendar.rst
+++ b/Doc/library/calendar.rst
@@ -469,6 +469,29 @@ The :mod:`calendar` module exports the following data attributes:
 
    Aliases for day numbers, where ``MONDAY`` is ``0`` and ``SUNDAY`` is ``6``.
 
+
+The :mod:`calendar` module defines the following exceptions:
+
+.. exception:: IllegalMonthError(month)
+
+   A subclass of :exc:`ValueError`,
+   raised when the given month number is outside of the range 1-12 (inclusive).
+
+   .. attribute:: month
+
+      The invalid month number.
+
+
+.. exception:: IllegalWeekdayError(weekday)
+
+   A subclass of :exc:`ValueError`,
+   raised when the given weekday number is outside of the range 0-6 (inclusive).
+
+   .. attribute:: weekday
+
+      The invalid weekday number.
+
+
 .. seealso::
 
    Module :mod:`datetime`