From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1649 invoked by alias); 21 Jun 2003 18:04:31 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 1629 invoked from network); 21 Jun 2003 18:04:29 -0000 Received: from unknown (HELO crack.them.org) (146.82.138.56) by sources.redhat.com with SMTP; 21 Jun 2003 18:04:29 -0000 Received: from dsl093-172-017.pit1.dsl.speakeasy.net ([66.93.172.17] helo=nevyn.them.org ident=mail) by crack.them.org with asmtp (Exim 3.12 #1 (Debian)) id 19Tmjo-0006EX-00; Sat, 21 Jun 2003 13:05:20 -0500 Received: from drow by nevyn.them.org with local (Exim 3.36 #1 (Debian)) id 19Tmiw-0002bl-00; Sat, 21 Jun 2003 14:04:26 -0400 Date: Sat, 21 Jun 2003 18:04:00 -0000 From: Daniel Jacobowitz To: gdb-patches@sources.redhat.com, Andrew Cagney Cc: Eli Zaretskii Subject: Re: RFA/doc: Add agent expressions chapter Message-ID: <20030621180426.GD14161@nevyn.them.org> Mail-Followup-To: gdb-patches@sources.redhat.com, Andrew Cagney , Eli Zaretskii References: <20020806173627.GA18326@nevyn.them.org> <3D500C9E.6090407@ges.redhat.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.1i X-SW-Source: 2003-06/txt/msg00670.txt.bz2 On Tue, Aug 13, 2002 at 03:40:06PM -0500, Jim Blandy wrote: > > Andrew Cagney writes: > > > We've got some nice documentation for all the tracepoint agent expressions > > > code, but we don't include it in the manual. This patch adds that and fixes > > > a warning in the new chapter. OK? > > > > > I wonder. New chapter, new appendix (like the remote protocol), or > > part of gdbint? > > The agent expression language is part of the interface between GDB and > a stub that implements tracepoints --- so it's a public interface, in > the same sense that the remote protocol is a public interface. I > think it should go whereever the remote protocol docs go. Got distracted, never finished this. The consensus was to put this after the Remote Protocol appendix, and turn it into an appendix just like the remote protocol docs. Here's a patch which does that; OK? -- Daniel Jacobowitz MontaVista Software Debian GNU/Linux Developer 2003-06-21 Daniel Jacobowitz * Makefile.in (SFILES_INCLUDED): Add agentexpr.texi. * agentexpr.texi: Retitle section, and change it to an appendix. Comment out texinfo initialization. Factor a @var{} into two pieces to prevent makeinfo warnings. * gdb.texinfo: Add Agent Expressions appendix. Index: doc/Makefile.in =================================================================== RCS file: /cvs/src/src/gdb/doc/Makefile.in,v retrieving revision 1.29 diff -u -p -r1.29 Makefile.in --- doc/Makefile.in 10 May 2003 15:32:39 -0000 1.29 +++ doc/Makefile.in 21 Jun 2003 18:00:20 -0000 @@ -1,4 +1,4 @@ -##Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1999, 2000, 2002 +##Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1999, 2000, 2002, 2003 ##Free Software Foundation, Inc. # Makefile for GDB documentation. @@ -100,6 +100,7 @@ DVIPS = dvips GDB_DOC_SOURCE_INCLUDES = \ $(srcdir)/fdl.texi \ $(srcdir)/gpl.texi \ + $(srcdir)/agentexpr.texi \ $(READLINE_DIR)/rluser.texinfo \ $(READLINE_DIR)/inc-hist.texinfo GDB_DOC_BUILD_INCLUDES = \ Index: doc/agentexpr.texi =================================================================== RCS file: /cvs/src/src/gdb/doc/agentexpr.texi,v retrieving revision 1.3 diff -u -p -r1.3 agentexpr.texi --- doc/agentexpr.texi 20 Dec 2002 09:35:03 -0000 1.3 +++ doc/agentexpr.texi 21 Jun 2003 18:00:20 -0000 @@ -1,14 +1,14 @@ -\input texinfo +@c \input texinfo @c %**start of header -@setfilename agentexpr.info -@settitle GDB Agent Expressions -@setchapternewpage off +@c @setfilename agentexpr.info +@c @settitle GDB Agent Expressions +@c @setchapternewpage off @c %**end of header -Revision: $Id: agentexpr.texi,v 1.2 1998/12/09 21:23:46 jimb Exp $ +@c Revision: $Id: agentexpr.texi,v 1.2 1998/12/09 21:23:46 jimb Exp $ -@node The GDB Agent Expression Mechanism -@chapter The GDB Agent Expression Mechanism +@node Agent Expressions +@appendix The GDB Agent Expression Mechanism In some applications, it is not feasable for the debugger to interrupt the program's execution long enough for the developer to learn anything @@ -299,7 +299,7 @@ Pop two integers from the stack; let @va and @var{b} be the top value. Shift @var{a} left by @var{b} bits, and push the result. -@item @code{rsh_signed} (0x0a): @var{a} @var{b} @result{} @var{@code{(signed)}a>>b} +@item @code{rsh_signed} (0x0a): @var{a} @var{b} @result{} @code{(signed)}@var{a>>b} Pop two integers from the stack; let @var{a} be the next-to-top value, and @var{b} be the top value. Shift @var{a} right by @var{b} bits, inserting copies of the top bit at the high end, and push the result. Index: doc/gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.165 diff -u -p -r1.165 gdb.texinfo --- doc/gdb.texinfo 19 Jun 2003 01:31:47 -0000 1.165 +++ doc/gdb.texinfo 21 Jun 2003 18:00:23 -0000 @@ -156,6 +156,7 @@ Copyright (C) 1988-2003 Free Software Fo * Installing GDB:: Installing GDB * Maintenance Commands:: Maintenance Commands * Remote Protocol:: GDB Remote Serial Protocol +* Agent Expressions:: The GDB Agent Expression Mechanism * Copying:: GNU General Public License says how you can copy and share GDB * GNU Free Documentation License:: The license for this documentation @@ -21719,6 +21720,8 @@ host is called: -> @code{X1234,6:XXXXXX} <- @code{T02} @end smallexample + +@include agentexpr.texi @include gpl.texi