From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 11 Mar 2024 22:11:36 +0000 (+0100)
Subject: [3.11] gh-116563: Update tutorial error example (GH-116569) (#116625)
X-Git-Tag: v3.11.9~72
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=830fbe9b6e6022c500e83e9c3180e5eac36a00ba;p=thirdparty%2FPython%2Fcpython.git

[3.11] gh-116563: Update tutorial error example (GH-116569) (#116625)

There now may be multiple carets pointing at a token
rather than just a character.  Fix the sentence about
possible causes.
(cherry picked from commit 3e45030076bf2cfab41c4456c73fb212b7322c60)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
---

diff --git a/Doc/tutorial/errors.rst b/Doc/tutorial/errors.rst
index 4058ebe8efdb..0b9acd00fdc6 100644
--- a/Doc/tutorial/errors.rst
+++ b/Doc/tutorial/errors.rst
@@ -20,12 +20,12 @@ complaint you get while you are still learning Python::
    >>> while True print('Hello world')
      File "<stdin>", line 1
        while True print('Hello world')
-                      ^
+                  ^^^^^
    SyntaxError: invalid syntax
 
-The parser repeats the offending line and displays a little 'arrow' pointing at
-the earliest point in the line where the error was detected.  The error is
-caused by (or at least detected at) the token *preceding* the arrow: in the
+The parser repeats the offending line and displays little 'arrow's pointing
+at the token in the line where the error was detected.  The error may be
+caused by the absence of a token *before* the indicated token.  In the
 example, the error is detected at the function :func:`print`, since a colon
 (``':'``) is missing before it.  File name and line number are printed so you
 know where to look in case the input came from a script.