Mention frame.f_trace in :func:sys.settrace docs.

[cool-RR]

BPO	37937
Nosy	@ncoghlan, @cool-RR, @serhiy-storchaka, @miss-islington
PRs	bpo-37937: Mention frame.f_trace in sys.settrace docs #15439 [3.8] bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439) #16296 [3.7] bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439) #16297

^{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 = <Date 2019-09-20.15:22:01.188>
created_at = <Date 2019-08-24.10:00:35.461>
labels = ['3.8', 'type-feature', '3.7', '3.9', 'docs']
title = 'Mention ``frame.f_trace`` in :func:`sys.settrace` docs.'
updated_at = <Date 2019-09-20.15:26:30.580>
user = 'https://github.com/cool-RR'

bugs.python.org fields:

activity = <Date 2019-09-20.15:26:30.580>
actor = 'miss-islington'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-09-20.15:22:01.188>
closer = 'ncoghlan'
components = ['Documentation']
creation = <Date 2019-08-24.10:00:35.461>
creator = 'cool-RR'
dependencies = []
files = []
hgrepos = []
issue_num = 37937
keywords = ['patch']
message_count = 6.0
messages = ['351293', '351295', '352855', '352858', '352860', '352861']
nosy_count = 5.0
nosy_names = ['ncoghlan', 'cool-RR', 'docs@python', 'serhiy.storchaka', 'miss-islington']
pr_nums = ['15439', '16296', '16297']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue37937'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9']

[serhiy-storchaka]

AFAIK setting frame.f_trace *instead* of calling sys.settrace() does not work. You need to call sys.settrace() to enable tracing.

[cool-RR]

Serhiy: I confirmed what you're saying and corrected the documentation. Could you please review?

[ncoghlan]

New changeset 9c2682e by Nick Coghlan (Ram Rachum) in branch 'master':
bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439)
9c2682e

[ncoghlan]

Thanks for the PR, Ram, and the initial review, Serhiy.

[miss-islington]

New changeset fd4f28d by Miss Islington (bot) in branch '3.7':
bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439)
fd4f28d

[miss-islington]

New changeset c410390 by Miss Islington (bot) in branch '3.8':
bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439)
c410390