From: Terry Jan Reedy <tjreedy@udel.edu>
Date: Mon, 11 Mar 2024 22:01:08 +0000 (-0400)
Subject: gh-116563: Update tutorial error example (#116569)
X-Git-Tag: v3.13.0a5~15
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3e45030076bf2cfab41c4456c73fb212b7322c60;p=thirdparty%2FPython%2Fcpython.git

gh-116563: Update tutorial error example (#116569)

There now may be multiple carets pointing at a token
rather than just a character.  Fix the sentence about
possible causes.
---

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.