[doc] Write argparse i18n howto

[merwok]

BPO	10529
Nosy	@rhettinger, @jwilk, @merwok

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2010-11-25.12:28:07.697>
labels = ['type-feature', '3.8', '3.9', '3.10', 'docs']
title = '[doc] Write argparse i18n howto'
updated_at = <Date 2020-11-07.20:23:43.051>
user = 'https://github.com/merwok'

bugs.python.org fields:

activity = <Date 2020-11-07.20:23:43.051>
actor = 'rhettinger'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2010-11-25.12:28:07.697>
creator = 'eric.araujo'
dependencies = []
files = []
hgrepos = []
issue_num = 10529
keywords = []
message_count = 3.0
messages = ['122358', '122359', '380524']
nosy_count = 6.0
nosy_names = ['rhettinger', 'bethard', 'jwilk', 'eric.araujo', 'docs@python', 'tshepang']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'needs patch'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue10529'
versions = ['Python 3.8', 'Python 3.9', 'Python 3.10']

Linked PRs

• gh-54738: Add argparse i18n howto #104562
• [3.11] gh-54738: Add argparse i18n howto (GH-104562) #107101
• [3.12] gh-54738: Add argparse i18n howto (GH-104562) #107102

[merwok]

argparse helpfully makes its messages with gettext.gettext. The docs should explain how to benefit from that in one’s program.

[merwok]

s/makes/marks/

[rhettinger]

This is a great idea. I'm thinking that the Argparse Tutorial is the right place for this: https://docs.python.org/3/howto/argparse.html

[hauntsaninja]

This is a nice docs feature, thank you!

[merwok]

I wished I’d got a notification of the PR! (links don’t create notifications)
Great that someone took this.