|
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
|
@@ -189,4 +189,4 @@ would typically correspond to a python function.
|
189 | 189 |
|
190 | 190 | .. c:function:: int PyMonitoring_ExitScope(void)
|
191 | 191 |
|
192 |
| - Exit the last scope that was entered with ``PyMonitoring_EnterScope``. |
| 192 | + Exit the last scope that was entered with :c:func:`!PyMonitoring_EnterScope`. |
0 commit comments