From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 119600 invoked by alias); 24 Sep 2018 07:10:17 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 119584 invoked by uid 89); 24 Sep 2018 07:10:16 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-2.3 required=5.0 tests=AWL,BAYES_00,SPF_PASS autolearn=ham version=3.3.2 spammy=english, English, speakers X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 24 Sep 2018 07:10:14 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g4L0R-0007Gi-BC for gdb-patches@sourceware.org; Mon, 24 Sep 2018 03:10:12 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:57813) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4L0R-0007Gc-7P; Mon, 24 Sep 2018 03:10:07 -0400 Received: from [176.228.60.248] (port=3673 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1g4L0Q-0005tj-R8; Mon, 24 Sep 2018 03:10:07 -0400 Date: Mon, 24 Sep 2018 07:10:00 -0000 Message-Id: <83lg7rbcc8.fsf@gnu.org> From: Eli Zaretskii To: Simon Marchi CC: tom@tromey.com, gdb-patches@sourceware.org In-reply-to: <6385b06c-ec1a-3e6e-6b81-a4c0f4097556@simark.ca> (message from Simon Marchi on Sun, 23 Sep 2018 22:39:03 -0400) Subject: Re: [PATCH 7/7] Allow setting a parameter to raise gdb.GdbError References: <20180915072459.14934-1-tom@tromey.com> <20180915072459.14934-8-tom@tromey.com> <83va77i0ko.fsf@gnu.org> <6385b06c-ec1a-3e6e-6b81-a4c0f4097556@simark.ca> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2018-09/txt/msg00799.txt.bz2 > Cc: gdb-patches@sourceware.org > From: Simon Marchi > Date: Sun, 23 Sep 2018 22:39:03 -0400 > > >> +If this method raises @code{gdb.GdbError} (@pxref{Exception > > > > "raises the 'gdb.GdbError' exception", I presume? > > I think that was intentional, I often see it written this way. Here's > an example from the Python doc: > > https://docs.python.org/2/library/string.html#string.index I understand, but this text could be confusing, especially to non-native English speakers, and is more confusing as the length of the exception's name becomes longer and includes stuff other than just "error". So I think we should not use this paradigm here, to keep the confusion level down.