From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25642 invoked by alias); 26 Jul 2008 19:26:05 -0000 Received: (qmail 25631 invoked by uid 22791); 26 Jul 2008 19:26:05 -0000 X-Spam-Check-By: sourceware.org Received: from mtaout4.012.net.il (HELO mtaout4.012.net.il) (84.95.2.10) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 26 Jul 2008 19:25:45 +0000 Received: from HOME-C4E4A596F7 ([77.127.123.9]) by i_mtaout4.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0K4M00BTUOLIKM60@i_mtaout4.012.net.il> for gdb-patches@sourceware.org; Sat, 26 Jul 2008 22:24:55 +0300 (IDT) Date: Sat, 26 Jul 2008 19:26:00 -0000 From: Eli Zaretskii Subject: Re: [RFA][patch 1/9] Yet another respin of the patch with initial Python support In-reply-to: <20080726182957.GA12363@caradoc.them.org> X-012-Sender: halo1@inter.net.il To: Daniel Jacobowitz Cc: tromey@redhat.com, bauerman@br.ibm.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: References: <20080615181833.uxmo25mg0kko40kw@imap.linux.ibm.com> <1216107418.14956.27.camel@localhost.localdomain> <1216245620.12209.18.camel@localhost.localdomain> <20080718195010.GA14356@caradoc.them.org> <1216653969.31797.6.camel@localhost.localdomain> <20080726182957.GA12363@caradoc.them.org> X-IsSubscribed: yes 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 X-SW-Source: 2008-07/txt/msg00499.txt.bz2 > Date: Sat, 26 Jul 2008 14:29:57 -0400 > From: Daniel Jacobowitz > Cc: tromey@redhat.com, bauerman@br.ibm.com, gdb-patches@sourceware.org > > On Sat, Jul 26, 2008 at 09:10:18PM +0300, Eli Zaretskii wrote: > > > >> +@value{GDBN} introduces a new Python module, named @code{gdb}. All > > > >> +methods and classes added by @value{GDBN} are placed in this module. > > > > > > Eli> OK, but what does this mean for whoever writes Python extensions for > > > Eli> GDB? While at that, how about explaining why a command FOO is indexed > > > Eli> as gdb.FOO? > > > > > > I thought it would be nice to index them both ways. Do you disagree? > > > > > > Python programmers know what the module stuff means. We don't have to > > > explain that. > > > > Sorry, I disagree. > > What would you like explained? Why it is important to the manual reader to know that there's a module called `gdb', and that all methods and classes added by GDB are placed in that module. Suppose I didn't know that--what would I be missing as result, and what code would I get wrong? > > > >> +Find the value of a @value{GDBN} setting. > > > > > > Eli> "find" or "display"? If the former, why the name is "show"? > > > > > > It mimics the CLI command name. > > > > ??? CLI commands that begin with "show" actually display the values. > > This one does not, right? > > I suggest "get" parallel to "set", then. Fine with me.