From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29618 invoked by alias); 2 Apr 2014 02:55:07 -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 29596 invoked by uid 89); 2 Apr 2014 02:55:04 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout22.012.net.il Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 02 Apr 2014 02:55:02 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0N3D00K00UCYY200@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Wed, 02 Apr 2014 05:54:59 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N3D00KK8URMUZ20@a-mtaout22.012.net.il>; Wed, 02 Apr 2014 05:54:59 +0300 (IDT) Date: Wed, 02 Apr 2014 02:55:00 -0000 From: Eli Zaretskii Subject: Re: [Patch v12 1/4] Documentation of the debug method support in GDB Python API In-reply-to: To: Siva Chandra Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <831txgcuer.fsf@gnu.org> References: X-IsSubscribed: yes X-SW-Source: 2014-04/txt/msg00018.txt.bz2 > Date: Tue, 1 Apr 2014 15:52:46 -0700 > From: Siva Chandra > > Siva> +The @value{GDBN} Python API provides classes, interfaces and functions > Siva> +to implement, register and manipulate debug methods. The core concepts > Siva> +involved in implementing debug methods are @emph{debug method matchers} > Siva> +and @emph{debug method workers}. > > Eli> The last sentence is a repetition of what the previous section said. > Eli> Do we really need this here? > > I can remove the repetitive sentence. However, for the HTML version of > the manual with each node on its own page, the repetition makes the > page self contained (I think). You can put a cross-reference to that other node. > Siva> +An instance of @code{DebugMethodMatcher} has the following attributes: > Siva> + > Siva> +@defvar DebugMethodMatcher.name > Siva> +The name of the matcher. > Siva> +@end defvar > > Eli> I think we use only the attribute name, without the class name. > > Are you referring to 'DebugMethodMatcher.name'? I find that other > Python types are also documented in this fashion. They are all wrong. The majority doesn't.