This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
Re: RFA/doc: Add agent expressions chapter
- From: Daniel Jacobowitz <drow at mvista dot com>
- To: gdb-patches at sources dot redhat dot com, Andrew Cagney <cagney at redhat dot com>
- Cc: Eli Zaretskii <eliz at gnu dot org>
- Date: Sat, 21 Jun 2003 14:04:26 -0400
- Subject: Re: RFA/doc: Add agent expressions chapter
- References: <20020806173627.GA18326@nevyn.them.org> <3D500C9E.6090407@ges.redhat.com> <vt27kiuze55.fsf@zenia.red-bean.com>
On Tue, Aug 13, 2002 at 03:40:06PM -0500, Jim Blandy wrote:
>
> Andrew Cagney <ac131313@ges.redhat.com> 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 <drow@mvista.com>
* 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