From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-61417-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 23595 invoked by alias); 2 Feb 2009 19:49:02 -0000
Received: (qmail 23586 invoked by uid 22791); 2 Feb 2009 19:49:01 -0000
X-SWARE-Spam-Status: No, hits=-1.4 required=5.0 	tests=AWL,BAYES_00,J_CHICKENPOX_37,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout5.012.net.il (HELO mtaout5.012.net.il) (84.95.2.13)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 02 Feb 2009 19:48:52 +0000
Received: from conversion-daemon.i_mtaout5.012.net.il by i_mtaout5.012.net.il (HyperSendmail v2004.12) id <0KEG00900ELZRF00@i_mtaout5.012.net.il> for gdb-patches@sourceware.org; Mon, 02 Feb 2009 21:48:00 +0200 (IST)
Received: from HOME-C4E4A596F7 ([84.228.158.130]) by i_mtaout5.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KEG00D4HEZT6MO0@i_mtaout5.012.net.il>; Mon, 02 Feb 2009 21:47:59 +0200 (IST)
Date: Mon, 02 Feb 2009 19:49:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [RFC][python] Add support for convenience functions implemented in 	Python
In-reply-to: <1233580604.7000.18.camel@localhost.localdomain>
To: Thiago Jung Bauermann <bauerman@br.ibm.com>
Cc: gdb-patches@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <u3aewwrhk.fsf@gnu.org>
References: <1233580604.7000.18.camel@localhost.localdomain>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2009-02/txt/msg00036.txt.bz2

> From: Thiago Jung Bauermann <bauerman@br.ibm.com>
> Date: Mon, 02 Feb 2009 11:16:44 -0200
> 
> gdb/doc/
> 2008-02-02  Tom Tromey  <tromey@redhat.com>
> 
> 	* gdb.texinfo (Convenience Vars): Document convenience functions.
> 	(Functions In Python): New node.
> 	(Python API): Update.

Approved, with comments:

> +@value{GDBN}.  The @var{name} argument is the name of the function.
> +This must be a string.  The function is made visible to the user as a
> +convenience variable, of ``internal function'' type, whose name is the
> +same as @var{name}.

Suggest to rephrase as follows:

  The argument @var{name} is the name of the function, a string.  The
  function will be visible to the user as a convenience variable of
  type @code{internal function}, whose name is the same as the given
  @var{name}.

Thanks.