Documentation

The module-level functions calendar.calendar() and calendar.prcal() document their first parameter as year:

.. function:: prcal(year, w=0, l=0, c=6, m=3)

.. function:: calendar(year, w=2, l=1, c=6, m=3)

However, both are bound methods of the module's TextCalendar instance (calendar = c.formatyear, prcal = c.pryear in Lib/calendar.py), whose first parameter is named theyear:

>>> import calendar, inspect
>>> inspect.signature(calendar.calendar)
<Signature (theyear, w=2, l=1, c=6, m=3)>
>>> inspect.signature(calendar.prcal)
<Signature (theyear, w=0, l=0, c=6, m=3)>

As a result the documented keyword name does not work — calendar.calendar(year=2025) raises TypeError, while calendar.calendar(theyear=2025) succeeds.

The documentation should be updated to use the real parameter name theyear, which also matches the sibling month() and prmonth() functions documented just above.

Linked PRs

• gh-153926: Fix documented parameter name for calendar.calendar and calendar.prcal #153927
• [3.15] gh-153926: Fix documented parameter name for calendar.calendar and calendar.prcal (GH-153927) #153937
• [3.14] gh-153926: Fix documented parameter name for calendar.calendar and calendar.prcal (GH-153927) #153938
• [3.13] gh-153926: Fix documented parameter name for calendar.calendar and calendar.prcal (GH-153927) #153939