Skip to content

Commit 7f7357d

Browse files
committed
docs: reword exceptions
1 parent 2f72323 commit 7f7357d

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

Doc/library/exceptions.rst

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -161,14 +161,15 @@ The following exceptions are used mostly as base classes for other exceptions.
161161

162162
.. attribute:: __timestamp_ns__
163163

164-
The time at which the exception instance was instantiated (usually when
165-
it was raised) in nanoseconds in :func:`time.time_ns` units. Display of
166-
this in tracebacks can be controlled using the
167-
:envvar:`PYTHON_TRACEBACK_TIMESTAMPS` environment variable. In
168-
applications with complicated exception chains and exception groups it be
169-
used to help visualize what happened when. The value will be 0 if a time
170-
was not recorded as is the case on :exc:`StopIteration` and
171-
:exc:`StopAsyncIteration`.
164+
The absolute time in nanoseconds at which the exception was instantiated
165+
(usually: when it was raised); as accurate as :func:`time.time_ns`.
166+
Display of this in tracebacks is off by default but can be controlled
167+
using the :envvar:`PYTHON_TRACEBACK_TIMESTAMPS` environment variable. In
168+
applications with complicated exception chains and exception groups it
169+
may be useful to help understand what happened when. The value will be
170+
``0`` if a timestamp was not recorded. :exc:`StopIteration` and
171+
:exc:`StopAsyncIteration` never record timestamps as those are primarily
172+
for control flow.
172173

173174
.. versionadded:: next
174175

0 commit comments

Comments
 (0)