GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — gh-161816: Fix documented parameter names in email.utils by thejesh23 · Pull Request #161818 · python/cpython

Conversation

@thejesh23

@thejesh23 thejesh23 commented Nov 11, 2026 •
edited by bedevere-app Bot
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Use the real parameter names in the email.utils docs, so that keyword calls written as documented work:

  • parseaddr(): address -> addr
  • parsedate(), parsedate_tz(), parsedate_to_datetime(): date -> data
  • mktime_tz(): tuple -> data

AI disclosure: prepared with the help of Claude Code; I reviewed the change.

  • Issue: Documented parameter names of some email.utils functions don't match the implementation #161816

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@thejesh23
Fix parameter names of some email.utils functions in docs
c08b89b
The documented names did not match the real ones, so passing the
argument by the documented keyword raised TypeError:

* parseaddr(): address -> addr
* parsedate(), parsedate_tz(), parsedate_to_datetime(): date -> data
* mktime_tz(): tuple -> data
@thejesh23
thejesh23 requested a review from a team as a code owner November 11, 2026 16:53
@bedevere-app bedevere-app Bot mentioned this pull request Nov 11, 2026
Documented parameter names of some email.utils functions don't match the implementation #161816
Open
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news awaiting review labels Nov 11, 2026
@github-project-automation github-project-automation Bot added this to Docs PRs Nov 11, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Nov 11, 2026
@read-the-docs-community

read-the-docs-community Bot commented Nov 11, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #35844242 | 📁 Comparing f5e28f9 against main (0ada998)

  🔍 Preview build  

12 files changed · ± 12 modified

± Modified

  • faq/design.html
  • faq/extending.html
  • faq/programming.html
  • library/email.utils.html
  • library/http.client.html
  • library/http.cookies.html
  • library/ssl.html
  • library/test.html
  • library/traceback.html
  • library/urllib.request.html
  • and 2 more...
thejesh23 reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

Eclips4
Eclips4 approved these changes Nov 11, 2026
View reviewed changes
@bedevere-app bedevere-app Bot added awaiting merge and removed awaiting review labels Nov 11, 2026
@thejesh23
Merge branch 'main' into email-utils-doc-param-names
f5e28f9
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Eclips4 Eclips4 Eclips4 approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

awaiting merge docs Documentation in the Doc dir skip news

Projects

Docs PRs
Status: Todo

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

2 participants

@thejesh23 @Eclips4
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.