* gdb.texinfo (Signaling): Update for symbolic symbol names

	and add a section explaining the difference between the GDB
	signal command and the shell kill utility.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index d9ef9deb765da0f53df8e454288da413058a3fa9..470a1d9f7e2c04ed723b4a07e394aad00799b45b 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+Thu Oct  7 16:15:37 1993  Jim Kingdon  (kingdon@lioth.cygnus.com)
+
+       * gdb.texinfo (Signaling): Update for symbolic symbol names
+       and add a section explaining the difference between the GDB
+       signal command and the shell kill utility.
+
 Wed Oct  6 13:23:01 1993  Tom Lord  (lord@rtl.cygnus.com)
 
        * libgdb.texinfo: added `@' to braces that were unescaped.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index e6168de689c00a8852f5a695a71ac0edaa61625b..341187f0b1130020625725868a9c7970438a61d7 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -6264,12 +6264,14 @@ already executed, in order to examine its execution in more detail.
 @section Giving your program a signal
 
 @table @code
-@item signal @var{signalnum}
+@item signal @var{signal}
 @kindex signal
 Resume execution where your program stopped, but immediately give it the
-signal number @var{signalnum}.
+signal @var{signal}.  @var{signal} can be the name or the number of a
+signal.  For example, on many systems @code{signal 2} and @code{signal
+SIGINT} are both ways of sending an interrupt signal.
 
-Alternatively, if @var{signalnum} is zero, continue execution without
+Alternatively, if @var{signal} is zero, continue execution without
 giving a signal.  This is useful when your program stopped on account of
 a signal and would ordinary see the signal when resumed with the
 @code{continue} command; @samp{signal 0} causes it to resume without a
@@ -6279,6 +6281,13 @@ signal.
 after executing the command.
 @end table
 @c @end group
+
+Invoking the @code{signal} command is not the same as invoking the
+@code{kill} utility from the shell.  Sending a signal with @code{kill}
+causes @value{GDBN} to decide what to do with the signal depending on
+the signal handling tables (@pxref{Signals}).  The @code{signal} command
+passes the signal directly to your program.
+
 @end ifclear
 
 @node Returning