Apply suggestions from code review

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
python · pablogsal · Oct 27, 2022 · Aug 29, 2022 · Aug 30, 2022 · Aug 30, 2022
commit db4aaa219f7e1090a44ec6a85f4c929eaf125c59
diff --git a/Doc/howto/perf_profiling.rst b/Doc/howto/perf_profiling.rst
@@ -151,12 +151,11 @@ Instead, if we run the same experiment with ``perf`` support enabled we get:
 How to enable ``perf`` profiling support
 ----------------------------------------
 
-There are three ways to enable ``perf`` profiling support;
-the environment variable :envvar:`PYTHONPERFSUPPORT` and the
-:option:`-X perf <-X>` option allow you to enable perf profiling from the start,
-whereas the :func:`sys.activate_stack_trampoline` and
-:func:`sys.deactivate_stack_trampoline` functions allow you to enable and
-    disable it dynamically.
+``perf`` profiling support can either be enabled from the start using
+the environment variable :envvar:`PYTHONPERFSUPPORT` or the
+:option:`-X perf <-X>` option,
+or dynamically using :func:`sys.activate_stack_trampoline` and
+:func:`sys.deactivate_stack_trampoline`.
 
 The :mod:`!sys` functions take precedence over the :option:`!-X` option,
 the :option:`!-X` option takes precedence over the environment variable.

diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
@@ -1558,7 +1558,7 @@ always available.
 .. function:: activate_stack_trampoline(backend, /)
 
    Activate the stack profiler trampoline *backend*.
-   The only supported backend is `"perf"`.
+   The only supported backend is ``"perf"``.
 
    .. availability:: Linux.