bpo-43705: Document that SyntaxError's offsets are 1-indexed (GH-25153)

Changed the inline mentions of the attributes into a proper attribute list like `SystemExit` has.

Automerge-Triggered-By: GH:gvanrossum
This commit is contained in:
Ammar Askar 2021-04-02 17:25:31 -04:00 committed by GitHub
parent f97dc80068
commit b2a91e0c9e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -402,9 +402,25 @@ The following exceptions are the exceptions that are usually raised.
or :func:`eval`, or when reading the initial script or standard input
(also interactively).
Instances of this class have attributes :attr:`filename`, :attr:`lineno`,
:attr:`offset` and :attr:`text` for easier access to the details. :func:`str`
of the exception instance returns only the message.
The :func:`str` of the exception instance returns only the error message.
.. attribute:: filename
The name of the file the syntax error occurred in.
.. attribute:: lineno
Which line number in the file the error occurred in. This is
1-indexed: the first line in the file has a ``lineno`` of 1.
.. attribute:: offset
The column in the line where the error occurred. This is
1-indexed: the first character in the line has an ``offset`` of 1.
.. attribute:: text
The source code text involved in the error.
.. exception:: IndentationError