From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <tromey@sourceware.org>
Received: by sourceware.org (Postfix, from userid 2126)
 id E440F3858D32; Wed, 15 Jun 2022 20:00:55 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E440F3858D32
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: Tom Tromey <tromey@sourceware.org>
To: gdb-cvs@sourceware.org
Subject: [binutils-gdb] Add to documentation of Python 'dont_repeat' method
X-Act-Checkin: binutils-gdb
X-Git-Author: Tom Tromey <tom@tromey.com>
X-Git-Refname: refs/heads/master
X-Git-Oldrev: b9b66a3a5740dfa0cf929a9c9abcdbaabe989358
X-Git-Newrev: 285dfa0f6877ea7677e84c3c1001c5d339fbbe5e
Message-Id: <20220615200055.E440F3858D32@sourceware.org>
Date: Wed, 15 Jun 2022 20:00:55 +0000 (GMT)
X-BeenThere: gdb-cvs@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gdb-cvs mailing list <gdb-cvs.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/gdb-cvs>,
 <mailto:gdb-cvs-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/gdb-cvs/>
List-Help: <mailto:gdb-cvs-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/gdb-cvs>,
 <mailto:gdb-cvs-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Wed, 15 Jun 2022 20:00:56 -0000

https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D285dfa0f6877=
ea7677e84c3c1001c5d339fbbe5e

commit 285dfa0f6877ea7677e84c3c1001c5d339fbbe5e
Author: Tom Tromey <tom@tromey.com>
Date:   Sat Feb 19 09:33:12 2022 -0700

    Add to documentation of Python 'dont_repeat' method
   =20
    PR python/28533 points out that the Python 'dont_repeat' documentation
    is a bit ambiguous about when the method ought to be called.  This
    patch spells it out.

Diff:
---
 gdb/doc/python.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 75804ef975e..62db5f27016 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -4001,8 +4001,10 @@ not documented.'' is used.
 @defun Command.dont_repeat ()
 By default, a @value{GDBN} command is repeated when the user enters a
 blank line at the command prompt.  A command can suppress this
-behavior by invoking the @code{dont_repeat} method.  This is similar
-to the user command @code{dont-repeat}, see @ref{Define, dont-repeat}.
+behavior by invoking the @code{dont_repeat} method at some point in
+its @code{invoke} method (normally this is done early in case of
+exception).  This is similar to the user command @code{dont-repeat},
+see @ref{Define, dont-repeat}.
 @end defun
=20
 @defun Command.invoke (argument, from_tty)