1
1
.. highlight :: c
2
2
3
- .. _ monitoring :
3
+ .. _ c-api-monitoring :
4
4
5
5
Monitoring C API
6
6
================
@@ -141,18 +141,18 @@ would typically correspond to a python function.
141
141
to the base-2 logarithm of ``sys.monitoring.events.PY_START``.
142
142
``state_array`` is an array with a monitoring state entry for each event in
143
143
``event_types``, it is allocated by the user but populated by
144
- `` PyMonitoring_EnterScope` ` with information about the activation state of
144
+ :c:func:`! PyMonitoring_EnterScope` with information about the activation state of
145
145
the event. The size of ``event_types`` (and hence also of ``state_array``)
146
146
is given in ``length``.
147
147
148
148
The ``version`` argument is a pointer to a value which should be allocated
149
149
by the user together with ``state_array`` and initialized to 0,
150
- and then set only by `` PyMonitoring_EnterScope` ` itelf. It allows this
150
+ and then set only by :c:func:`! PyMonitoring_EnterScope` itelf. It allows this
151
151
function to determine whether event states have changed since the previous call,
152
152
and to return quickly if they have not.
153
153
154
154
The scopes referred to here are lexical scopes: a function, class or method.
155
- `` PyMonitoring_EnterScope` ` should be called whenever the lexical scope is
155
+ :c:func:`! PyMonitoring_EnterScope` should be called whenever the lexical scope is
156
156
entered. Scopes can be reentered, reusing the same *state_array* and *version*,
157
157
in situations like when emulating a recursive Python function. When a code-like's
158
158
execution is paused, such as when emulating a generator, the scope needs to
@@ -161,4 +161,4 @@ would typically correspond to a python function.
161
161
162
162
.. :c:function:: int PyMonitoring_ExitScope(void)
163
163
164
- Exit the last scope that was entered with `` PyMonitoring_EnterScope` `.
164
+ Exit the last scope that was entered with :c:func:`! PyMonitoring_EnterScope`.
0 commit comments