René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Docs: `calendar.calendar` and `calendar.prcal` document parameter as `year` but it is named `theyear`","articleBody":"# Documentation\n\nThe module-level functions [`calendar.calendar()`](https://docs.python.org/3/library/calendar.html#calendar.calendar) and [`calendar.prcal()`](https://docs.python.org/3/library/calendar.html#calendar.prcal) document their first parameter as `year`:\n\n```rst\n.. function:: prcal(year, w=0, l=0, c=6, m=3)\n\n.. function:: calendar(year, w=2, l=1, c=6, m=3)\n```\n\nHowever, 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`:\n\n```pycon\n>>> import calendar, inspect\n>>> inspect.signature(calendar.calendar)\n\u003cSignature (theyear, w=2, l=1, c=6, m=3)>\n>>> inspect.signature(calendar.prcal)\n\u003cSignature (theyear, w=0, l=0, c=6, m=3)>\n```\n\nAs a result the documented keyword name does not work — `calendar.calendar(year=2025)` raises `TypeError`, while `calendar.calendar(theyear=2025)` succeeds.\n\nThe documentation should be updated to use the real parameter name `theyear`, which also matches the sibling `month()` and `prmonth()` functions documented just above.\n\n\n\u003c!-- gh-linked-prs -->\n### Linked PRs\n* gh-153927\n* gh-153937\n* gh-153938\n* gh-153939\n\u003c!-- /gh-linked-prs -->\n","author":{"url":"https://github.com/fedonman","@type":"Person","name":"fedonman"},"datePublished":"2026-07-18T11:43:29Z","url":"https://github.com/python/cpython/issues/153926"}