From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 30 Dec 2024 17:40:31 +0000 (+0100)
Subject: [3.12] gh-128317: Document `calendar.TextCalendar.formatweek` (GH-128353) (#128358)
X-Git-Tag: v3.12.9~130
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b22d0fcbe17c0a2108f30ff3fc69c72ca3d9540d;p=thirdparty%2FPython%2Fcpython.git

[3.12] gh-128317: Document `calendar.TextCalendar.formatweek` (GH-128353) (#128358)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---

diff --git a/Doc/library/calendar.rst b/Doc/library/calendar.rst
index 102bc2871799..4b82e52bf3d8 100644
--- a/Doc/library/calendar.rst
+++ b/Doc/library/calendar.rst
@@ -138,6 +138,14 @@ interpreted as prescribed by the ISO 8601 standard.  Year 0 is 1 BC, year -1 is
 
    :class:`TextCalendar` instances have the following methods:
 
+   .. method:: formatweek(theweek, w=0)
+
+      Return a single week in a string with no newline. If *w* is provided, it
+      specifies the width of the date columns, which are centered. Depends
+      on the first weekday as specified in the constructor or set by the
+      :meth:`setfirstweekday` method.
+
+
    .. method:: formatmonth(theyear, themonth, w=0, l=0)
 
       Return a month's calendar in a multi-line string. If *w* is provided, it