From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-94047-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 30802 invoked by alias); 23 Aug 2012 16:47:59 -0000
Received: (qmail 30705 invoked by uid 22791); 23 Aug 2012 16:47:57 -0000
X-SWARE-Spam-Status: No, hits=-4.1 required=5.0	tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,RCVD_IN_NIX_SPAM,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout23.012.net.il (HELO mtaout23.012.net.il) (80.179.55.175)    by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 23 Aug 2012 16:47:44 +0000
Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0M9700900VSBG800@a-mtaout23.012.net.il> for gdb-patches@sourceware.org; Thu, 23 Aug 2012 19:47:41 +0300 (IDT)
Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M97009ODVZGDZ50@a-mtaout23.012.net.il>; Thu, 23 Aug 2012 19:47:41 +0300 (IDT)
Date: Thu, 23 Aug 2012 16:47:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: Document how to exit "python-interactive"
In-reply-to: <E4E55FE9-8E45-49D4-8DC7-31A2DC7EE56E@cs.umd.edu>
To: Khoo Yit Phang <khooyp@cs.umd.edu>
Cc: gdb-patches@sourceware.org, khooyp@cs.umd.edu
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83boi1a72i.fsf@gnu.org>
References: <E4E55FE9-8E45-49D4-8DC7-31A2DC7EE56E@cs.umd.edu>
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: 2012-08/txt/msg00676.txt.bz2

> From: Khoo Yit Phang <khooyp@cs.umd.edu>
> Date: Thu, 23 Aug 2012 12:29:17 -0400
> Cc: Khoo Yit Phang <khooyp@cs.umd.edu>
> 
> I'd like to update the documentation to explain how to return from "python-interactive" to GDB.

Thanks.

> 
> Thanks!
> 
> Yit
> August 23, 2012
> 
> 
> [2:text/plain Hide Save:python-interactive-exit.txt (1kB)]
> 
> # HG changeset patch
> # Parent 3a8ab84de40f6a3b09615bd9f9acef671062c85c
> Document how to return from "python-interactive" to GDB.
> 
> gdb/ChangeLog:
> 
> 2012-08-23  Khoo Yit Phang <khooyp@cs.umd.edu>
> 
> 	Document how to return from "python-interactive" to GDB.
> 	* doc/gdb.texinfo (Python Commands): Update documentation.
> 	* python/python.c (_initialize_python): Update documentation.
> 
> diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -22515,7 +22515,8 @@
>  @item python-interactive @r{[}@var{command}@r{]}
>  @itemx pi @r{[}@var{command}@r{]}
>  Without an argument, the @code{python-interactive} command can be used
> -to start an interactive Python prompt.
> +to start an interactive Python prompt.  To return to @value{GDBN},
> +type @code{EOF} (e.g., @samp{Ctrl-D}) on an empty prompt.

I think "type the @code{EOF} character" is better.

Also, please use @kbd{Ctrl-D}.  Finally, I think "on the empty prompt"
is redundant (and may even be incorrect -- doesn't it work even on a
non-empty line?).

>  	   python_interactive_command,
>  #ifdef HAVE_PYTHON
>  	   _("\
> -Start a Python interactive prompt.\n\
> +Start a Python interactive prompt.  To return to GDB, type EOF\n\

I think the second sentence should begin on a new line.  Don't you get
that line truncated in "apropos" output?

OK with those changes.