summaryrefslogtreecommitdiffstats
path: root/Doc/howto/instrumentation.rst
diff options
context:
space:
mode:
authorBenjamin Peterson <benjamin@python.org>2016-09-11 00:24:25 (GMT)
committerBenjamin Peterson <benjamin@python.org>2016-09-11 00:24:25 (GMT)
commit699e2c91f61bdacec177a050f930e7dbd7cdb371 (patch)
tree8dbf935674c3fdd11c1573c05218c8c3dcc3da92 /Doc/howto/instrumentation.rst
parent4eef50506431d22c7488adf24feace29fded6d53 (diff)
downloadcpython-699e2c91f61bdacec177a050f930e7dbd7cdb371.zip
cpython-699e2c91f61bdacec177a050f930e7dbd7cdb371.tar.gz
cpython-699e2c91f61bdacec177a050f930e7dbd7cdb371.tar.bz2
reST is not markdown
Diffstat (limited to 'Doc/howto/instrumentation.rst')
-rw-r--r--Doc/howto/instrumentation.rst34
1 files changed, 17 insertions, 17 deletions
diff --git a/Doc/howto/instrumentation.rst b/Doc/howto/instrumentation.rst
index 2b21224..fa83775 100644
--- a/Doc/howto/instrumentation.rst
+++ b/Doc/howto/instrumentation.rst
@@ -280,23 +280,22 @@ Available static markers
The filename, function name, and line number are provided back to the
tracing script as positional arguments, which must be accessed using
- `$arg1`, `$arg2`, `$arg3`:
+ ``$arg1``, ``$arg2``, ``$arg3``:
- * `$arg1` : `(const char *)` filename, accessible using `user_string($arg1)`
+ * ``$arg1`` : ``(const char *)`` filename, accessible using ``user_string($arg1)``
- * `$arg2` : `(const char *)` function name, accessible using
- `user_string($arg2)`
+ * ``$arg2`` : ``(const char *)`` function name, accessible using
+ ``user_string($arg2)``
- * `$arg3` : `int` line number
+ * ``$arg3`` : ``int`` line number
.. c:function:: function__return(str filename, str funcname, int lineno)
- This marker is the converse of `function__entry`, and indicates that
- execution of a Python function has ended (either via ``return``, or
- via an exception). It is only triggered for pure-Python (bytecode)
- functions.
+ This marker is the converse of :c:func:`function__entry`, and indicates that
+ execution of a Python function has ended (either via ``return``, or via an
+ exception). It is only triggered for pure-Python (bytecode) functions.
- The arguments are the same as for `function__entry`
+ The arguments are the same as for :c:func:`function__entry`
.. c:function:: line(str filename, str funcname, int lineno)
@@ -304,17 +303,17 @@ Available static markers
the equivalent of line-by-line tracing with a Python profiler. It is
not triggered within C functions.
- The arguments are the same as for `function__entry`.
+ The arguments are the same as for :c:func:`function__entry`.
.. c:function:: gc__start(int generation)
Fires when the Python interpreter starts a garbage collection cycle.
- `arg0` is the generation to scan, like :func:`gc.collect()`.
+ ``arg0`` is the generation to scan, like :func:`gc.collect()`.
.. c:function:: gc__done(long collected)
Fires when the Python interpreter finishes a garbage collection
- cycle. `arg0` is the number of collected objects.
+ cycle. ``arg0`` is the number of collected objects.
SystemTap Tapsets
@@ -348,7 +347,7 @@ Here is a tapset file, based on a non-shared build of CPython:
}
If this file is installed in SystemTap's tapset directory (e.g.
-`/usr/share/systemtap/tapset`), then these additional probepoints become
+``/usr/share/systemtap/tapset``), then these additional probepoints become
available:
.. c:function:: python.function.entry(str filename, str funcname, int lineno, frameptr)
@@ -358,9 +357,10 @@ available:
.. c:function:: python.function.return(str filename, str funcname, int lineno, frameptr)
- This probe point is the converse of `python.function.return`, and indicates
- that execution of a Python function has ended (either via ``return``, or
- via an exception). It is only triggered for pure-python (bytecode) functions.
+ This probe point is the converse of :c:func:`python.function.return`, and
+ indicates that execution of a Python function has ended (either via
+ ``return``, or via an exception). It is only triggered for pure-python
+ (bytecode) functions.
Examples