sys.excepthook documentation doesn't mention that it isn't called for SystemExit

[cjwatson]

BPO	46759
Nosy	@cjwatson, @iritkatriel
PRs	GH-90915: Document that SystemExit doesn't trigger sys.excepthook #31357

^{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 2022-02-15.12:10:41.510>
labels = ['3.11', 'docs']
title = "sys.excepthook documentation doesn't mention that it isn't called for SystemExit"
updated_at = <Date 2022-03-20.09:50:38.228>
user = 'https://github.com/cjwatson'

bugs.python.org fields:

activity = <Date 2022-03-20.09:50:38.228>
actor = 'iritkatriel'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2022-02-15.12:10:41.510>
creator = 'cjwatson'
dependencies = []
files = []
hgrepos = []
issue_num = 46759
keywords = ['patch']
message_count = 2.0
messages = ['413285', '415598']
nosy_count = 3.0
nosy_names = ['cjwatson', 'docs@python', 'iritkatriel']
pr_nums = ['31357']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = None
url = 'https://bugs.python.org/issue46759'
versions = ['Python 3.11']

Linked PRs

• [3.12] GH-90915: Document that SystemExit doesn't trigger sys.excepthook (GH-31357) #109082
• [3.11] GH-90915: Document that SystemExit doesn't trigger sys.excepthook (GH-31357) #109083

[cjwatson]

In https://bugs.debian.org/1005803, Matthew Vernon reports that the library documentation for sys.excepthook doesn't mention the detail that that sys.excepthook isn't called for uncaught SystemExit exceptions, although help(sys) does mention this.

(He also mentions that help(sys.excepthook) doesn't mention this. I think this would make less sense, since that gets the docstring of a particular implementation of an excepthook - on a given system it might not be Python's built-in version, for instance. But adding information to the main library documentation seems reasonable.)

[iritkatriel]

See also bpo-25489.

[hugovk]

Thanks, fixed via #31357 and backports to 3.11.