Re: [commit] gdb.texinfo

Eli Zaretskii
2006-10-15T21:36:14Z

> Date: Sun, 15 Oct 2006 10:03:35 +1300
> Cc: gdb-patches@sources.redhat.com
>
> There are many similar discrepancies in the manual
>
> `info signals'
> `info handle'
>
> should be:
>
> `info signals [N]'
> `info handle [N]'

Fixed.

> `handle SIGNAL KEYWORDS...'
>
> should be:
>
> `handle SIGNAL [KEYWORDS...]'

Fixed.

> Incidentally `handle SIGINT' asks
>
> SIGINT is used by the debugger.
> Are you sure you want to change it? (y or n)
>
> even though it doesn't appear to change anything

Sorry, I'm not following: what do you mean by ``doesn't appear to
change anything''?

> info breakpoints [N]
>
> doesn't describe what [N] does...

Fixed. Here's what I committed:

2006-10-15 Eli Zaretskii <eliz@gnu.org>

* gdb.texinfo (Signals, Set Breaks, Set Watchpoints): Document optional
arguments to `info signals' `handle', `info breakpoints', and
`info watchpoints'.

Index: gdb/doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.359
diff -u -r1.359 gdb.texinfo
--- gdb/doc/gdb.texinfo 15 Oct 2006 21:19:24 -0000 1.359
+++ gdb/doc/gdb.texinfo 15 Oct 2006 21:32:31 -0000
@@ -2985,7 +2985,9 @@
@itemx info break @r{[}@var{n}@r{]}
@itemx info watchpoints @r{[}@var{n}@r{]}
Print a table of all breakpoints, watchpoints, and catchpoints set and
-not deleted, with the following columns for each breakpoint:
+not deleted. Optional argument @var{n} means print information only
+about the specified breakpoint (or watchpoint or catchpoint). For
+each breakpoint, following columns are printed:

@table @emph
@item Breakpoint Numbers
@@ -3135,7 +3137,7 @@
Set a watchpoint that will break when @var{expr} is either read from
or written into by the program.

-@kindex info watchpoints
+@kindex info watchpoints @r{[}@var{n}@r{]}
@item info watchpoints
This command prints a list of watchpoints, breakpoints, and catchpoints;
it is the same as @code{info break} (@pxref{Set Breaks}).
@@ -4130,15 +4132,19 @@
handle each one. You can use this to see the signal numbers of all
the defined types of signals.

+@item info signals @var{sig}
+Similar, but print information only about the specified signal number.
+
@code{info handle} is an alias for @code{info signals}.

@kindex handle
-@item handle @var{signal} @var{keywords}@dots{}
+@item handle @var{signal} @r{[}@var{keywords}@dots{}@r{]}
Change the way @value{GDBN} handles signal @var{signal}. @var{signal}
can be the number of a signal or its name (with or without the
@samp{SIG} at the beginning); a list of signal numbers of the form
@samp{@var{low}-@var{high}}; or the word @samp{all}, meaning all the
-known signals. The @var{keywords} say what change to make.
+known signals. Optional arguments @var{keywords}, described below,
+say what change to make.
@end table

@c @group