From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 8711 invoked by alias); 18 Nov 2005 13:30:54 -0000 Received: (qmail 8695 invoked by uid 22791); 18 Nov 2005 13:30:51 -0000 Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66) by sourceware.org (qpsmtpd/0.30-dev) with ESMTP; Fri, 18 Nov 2005 13:30:51 +0000 Received: from HOME-C4E4A596F7 (IGLD-80-230-42-78.inter.net.il [80.230.42.78]) by romy.inter.net.il (MOS 3.5.8-GR) with ESMTP id CZT17357 (AUTH halo1); Fri, 18 Nov 2005 15:30:41 +0200 (IST) Date: Fri, 18 Nov 2005 14:06:00 -0000 Message-Id: From: Eli Zaretskii To: Kevin Buettner CC: gdb-patches@sources.redhat.com In-reply-to: <20051117195224.32094bd5@ironwood.lan> (message from Kevin Buettner on Thu, 17 Nov 2005 19:52:24 -0700) Subject: Re: [rfa/doc] Add section on interrupts to remote protocol documentation Reply-to: Eli Zaretskii References: <20051117195224.32094bd5@ironwood.lan> Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2005-11/txt/msg00323.txt.bz2 > Date: Thu, 17 Nov 2005 19:52:24 -0700 > From: Kevin Buettner > > The patch below adds a new section about interrupts to the remote protocol > documentation. A discussion on gdb@ may be found starting here: > > http://sources.redhat.com/ml/gdb/2005-11/msg00347.html > > Okay? Thanks. This is approved, but please fix the following minor gotchas before committing: > +When a program on the remote target is running, @value{GDBN} may > +attempt to interrupt it by sending a @samp{Ctrl-C} or a @code{BREAK}, > +control of which is specified via @value{GDBN}'s @samp{remotebreak} > +setting. @xref{set remotebreak}. It is better to use @pxref here, like this: control of which is specified via @value{GDBN}'s @samp{remotebreak} setting (@pxref{set remotebreak}). > +@code{0x03}. @samp{Ctrl-C} must not be sent as part of a packet as > +defined in the Overview section. @xref{Overview}. Same here: use @pxref. > +running program, it is expected that it will send one of the Stop > +Reply Packets (@xref{Stop Reply Packets}) to @value{GDBN} as a result @pxref is precisely the markup for the situations when you want a cross-reference in parentheses. @pxref does 2 things that are appropriate in parens: (1) it produces a phrase that begins with a lower-case letter, since this is not a beginning of a sentence; and (2) it doesn't require a period or a command after the closing brace, like @xref does. So please replace the above @xref with @pxref. Also, I'd like us to have an index entry pointing to this section. Could you please add one?