RFA/doc: Add agent expressions chapter

[Daniel Jacobowitz]

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?

-- 
Daniel Jacobowitz                           Carnegie Mellon University
MontaVista Software                         Debian GNU/Linux Developer

2002-08-06  Daniel Jacobowitz  <drow@mvista.com>

	* Makefile.in (SFILES_INCLUDED): Add agentexpr.texi.
	* agentexpr.texi: Retitle section.  Comment out initialization.
	Factor a @var{}.
	* gdb.texinfo: Add Agent Expressions chapter.

Index: Makefile.in
===================================================================
RCS file: /cvs/src/src/gdb/doc/Makefile.in,v
retrieving revision 1.20
diff -u -p -r1.20 Makefile.in
--- Makefile.in	25 Feb 2002 04:32:58 -0000	1.20
+++ Makefile.in	6 Aug 2002 17:34:36 -0000
@@ -99,6 +99,7 @@ DVIPS = dvips
 # Main GDB manual's source files
 SFILES_INCLUDED = gdb-cfg.texi \
 	$(srcdir)/annotate.texi \
+	$(srcdir)/agentexpr.texi \
 	$(srcdir)/fdl.texi \
 	$(srcdir)/gpl.texi
 
Index: agentexpr.texi
===================================================================
RCS file: /cvs/src/src/gdb/doc/agentexpr.texi,v
retrieving revision 1.2
diff -u -p -r1.2 agentexpr.texi
--- agentexpr.texi	16 Feb 2000 04:11:25 -0000	1.2
+++ agentexpr.texi	6 Aug 2002 17:34:36 -0000
@@ -1,13 +1,13 @@
-\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
+@node Agent Expressions
 @chapter The GDB Agent Expression Mechanism
 
 In some applications, it is not feasable for the debugger to interrupt
@@ -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: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.107
diff -u -p -r1.107 gdb.texinfo
--- gdb.texinfo	3 Aug 2002 23:37:07 -0000	1.107
+++ gdb.texinfo	6 Aug 2002 17:34:40 -0000
@@ -146,6 +146,7 @@ Copyright (C) 1988-2002 Free Software Fo
 * Emacs::                       Using @value{GDBN} under @sc{gnu} Emacs
 * Annotations::                 @value{GDBN}'s annotation interface.
 * GDB/MI::                      @value{GDBN}'s Machine Interface.
+* Agent Expressions::           The GDB Agent Expression Mechanism
 
 * GDB Bugs::                    Reporting bugs in @value{GDBN}
 * Formatting Documentation::    How to format and print @value{GDBN} documentation
@@ -13539,6 +13540,7 @@ each value is printed in its own window.
 
 @include annotate.texi
 @include gdbmi.texinfo
+@include agentexpr.texi
 
 @node GDB Bugs
 @chapter Reporting Bugs in @value{GDBN}