From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6973 invoked by alias); 5 Aug 2008 04:19:46 -0000 Received: (qmail 6962 invoked by uid 22791); 5 Aug 2008 04:19:44 -0000 X-Spam-Check-By: sourceware.org Received: from igw1.br.ibm.com (HELO igw1.br.ibm.com) (32.104.18.24) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 05 Aug 2008 04:19:01 +0000 Received: from mailhub1.br.ibm.com (mailhub1 [9.18.232.109]) by igw1.br.ibm.com (Postfix) with ESMTP id 83B0132C403 for ; Tue, 5 Aug 2008 00:50:20 -0300 (BRT) Received: from d24av01.br.ibm.com (d24av01.br.ibm.com [9.18.232.46]) by mailhub1.br.ibm.com (8.13.8/8.13.8/NCO v9.0) with ESMTP id m754IsiE1622230 for ; Tue, 5 Aug 2008 01:18:54 -0300 Received: from d24av01.br.ibm.com (loopback [127.0.0.1]) by d24av01.br.ibm.com (8.12.11.20060308/8.13.3) with ESMTP id m754Ilif003228 for ; Tue, 5 Aug 2008 01:18:48 -0300 Received: from [9.18.199.125] ([9.18.199.125]) by d24av01.br.ibm.com (8.12.11.20060308/8.12.11) with ESMTP id m754Il8N003207; Tue, 5 Aug 2008 01:18:47 -0300 Subject: Re: [RFA][patch 1/9] Yet another respin of the patch with initial Python support From: Thiago Jung Bauermann To: Eli Zaretskii Cc: tromey@redhat.com, drow@false.org, gdb-patches@sourceware.org In-Reply-To: References: <20080429155212.444237503@br.ibm.com> <20080429155304.288626880@br.ibm.com> <20080528205921.GA2969@caradoc.them.org> <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> Content-Type: text/plain Date: Tue, 05 Aug 2008 04:19:00 -0000 Message-Id: <1217909927.7578.61.camel@localhost.localdomain> Mime-Version: 1.0 X-Mailer: Evolution 2.22.3.1 Content-Transfer-Encoding: 7bit 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-08/txt/msg00072.txt.bz2 On Sat, 2008-07-26 at 21:10 +0300, Eli Zaretskii wrote: > > From: Tom Tromey > > >> +@value{GDBN} exposes a number of features to Python scripts. > > > > Eli> This should end with a colon, and the list of the features should be a > > Eli> @table. > > > > I guess those aren't really features, they are more like generic > > things that the python-in-gdb programmer ought to know. > > > > So, I don't think a table makes sense, but I suppose the current text > > is also misleading. What do you suggest? > > My problem is with the form, not with the content. By default, each > paragraph in a Texinfo document starts with an indentation, like in a > book. @table prevents that, producing paragraphs whose all lines line > up. This section presents a list of features; having each feature's > description begin with an indented line is simply ugly. We can sidestep the issue and actually get a better result in the end: The two paragraphs talking about exception handling should go to a new subsubsection, and the paragraph stdout and pagination should go to the "Basic Python" subsubsection. Then we can whack the "GDB exposes a number of features to Python scripts." sentence. IMO it is the best option. > You seem to think that @table produces a table, but it doesn't. Heh. :-) -- []'s Thiago Jung Bauermann IBM Linux Technology Center