This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA][patch 1/9] Yet another respin of the patch with initial Python support
- From: Thiago Jung Bauermann <bauerman at br dot ibm dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: tromey at redhat dot com, drow at false dot org, gdb-patches at sourceware dot org
- Date: Tue, 05 Aug 2008 01:18:47 -0300
- Subject: Re: [RFA][patch 1/9] Yet another respin of the patch with initial Python support
- 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> <m3od4z3w0t.fsf@fleche.redhat.com> <m3k5fl3ncy.fsf@fleche.redhat.com> <1216245620.12209.18.camel@localhost.localdomain> <20080718195010.GA14356@caradoc.them.org> <1216653969.31797.6.camel@localhost.localdomain> <uwsj84wx5.fsf@gnu.org> <m3prp0efvr.fsf@fleche.redhat.com> <uhcac4iut.fsf@gnu.org>
On Sat, 2008-07-26 at 21:10 +0300, Eli Zaretskii wrote:
> > From: Tom Tromey <tromey@redhat.com>
> > >> +@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