diff options
| author | Steve Dower <steve.dower@python.org> | 2019-10-26 20:02:30 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-10-26 20:02:30 (GMT) |
| commit | 894e30ce0bcc1c509eb01c8ffa9ba6d7701aeaaf (patch) | |
| tree | 4bcccc97453da258c43d262aaba971c0a26b287b /Doc/library | |
| parent | d898d20e8c228229eb68e545f544db13f246f216 (diff) | |
| download | cpython-894e30ce0bcc1c509eb01c8ffa9ba6d7701aeaaf.zip cpython-894e30ce0bcc1c509eb01c8ffa9ba6d7701aeaaf.tar.gz cpython-894e30ce0bcc1c509eb01c8ffa9ba6d7701aeaaf.tar.bz2 | |
bpo-38434: Fixes some audit event documentation (GH-16932)
Diffstat (limited to 'Doc/library')
| -rw-r--r-- | Doc/library/sys.rst | 19 | ||||
| -rw-r--r-- | Doc/library/types.rst | 4 |
2 files changed, 15 insertions, 8 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index c6c643b..a2e930b 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -33,18 +33,21 @@ always available. tuple of arguments. Native hooks added by :c:func:`PySys_AddAuditHook` are called first, followed by hooks added in the current interpreter. - Calling this function will trigger an event for all existing hooks, and if - any raise an exception derived from :class:`Exception`, the add will be - silently ignored. As a result, callers cannot assume that their hook has been - added unless they control all existing hooks. + .. audit-event:: sys.addaudithook "" sys.addaudithook + + Raises a auditing event ``sys.addaudithook`` with no arguments. If any + existing hooks raise an exception derived from :class:`Exception`, the + new hook will not be added and the exception suppressed. As a result, + callers cannot assume that their hook has been added unless they control + all existing hooks. .. versionadded:: 3.8 .. impl-detail:: - When tracing is enabled, Python hooks are only traced if the callable has - a ``__cantrace__`` member that is set to a true value. Otherwise, trace - functions will not see the hook. + When tracing is enabled (see :func:`settrace`), Python hooks are only + traced if the callable has a ``__cantrace__`` member that is set to a + true value. Otherwise, trace functions will skip the hook. .. data:: argv @@ -87,7 +90,7 @@ always available. native function is preferred when possible. See the :ref:`audit events table <audit-events>` for all events raised by - ``CPython``. + CPython. .. versionadded:: 3.8 diff --git a/Doc/library/types.rst b/Doc/library/types.rst index a21fb44..9393f9e 100644 --- a/Doc/library/types.rst +++ b/Doc/library/types.rst @@ -138,6 +138,10 @@ Standard names are defined for the following types: The type for code objects such as returned by :func:`compile`. + .. audit-event:: code.__new__ code,filename,name,argcount,posonlyargcount,kwonlyargcount,nlocals,stacksize,flags CodeType + + Note that the audited arguments may not match the names or positions + required by the initializer. .. data:: CellType |