From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1551) id 61F7F395A014; Tue, 31 May 2022 14:42:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 61F7F395A014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Pedro Alves To: gdb-cvs@sourceware.org Subject: [binutils-gdb] Improve clear command's documentation X-Act-Checkin: binutils-gdb X-Git-Author: Pedro Alves X-Git-Refname: refs/heads/master X-Git-Oldrev: 102a644eaaa8b258f021da71028c32e0744d73ce X-Git-Newrev: 622c4842bb451efd519c32312c2372f472cd99c8 Message-Id: <20220531144234.61F7F395A014@sourceware.org> Date: Tue, 31 May 2022 14:42:34 +0000 (GMT) X-BeenThere: gdb-cvs@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 31 May 2022 14:42:34 -0000 https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D622c4842bb45= 1efd519c32312c2372f472cd99c8 commit 622c4842bb451efd519c32312c2372f472cd99c8 Author: Pedro Alves Date: Tue May 31 10:54:17 2022 +0100 Improve clear command's documentation =20 Co-Authored-By: Eli Zaretskii =20 Change-Id: I9440052fd28f795d6f7c93a4576beadd21f28885 Diff: --- gdb/doc/gdb.texinfo | 35 +++++++++++++++++++++++++---------- 1 file changed, 25 insertions(+), 10 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index f94df686bab..5f09f3a1433 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -5443,21 +5443,36 @@ the innermost frame is selected, this is a good way= to delete a breakpoint where your program just stopped. =20 @item clear @var{locspec} -Delete breakpoints with code locations that match @var{locspec}. -@xref{Location Specifications}, for the various forms of -@var{locspec}; the most useful ones are listed below: +Delete any breakpoint with a code location that corresponds to +@var{locspec}. @xref{Location Specifications}, for the various forms +of @var{locspec}. Which code locations correspond to @var{locspec} +depends on the form used in the location specification @var{locspec}: =20 @table @code -@item clear @var{function} -@itemx clear @var{filename}:@var{function} -Delete any breakpoints set at entry to the named @var{function}. +@item @var{linenum} +@itemx @var{filename}:@var{linenum} +@itemx -line @var{linenum} +@itemx -source @var{filename} -line @var{linenum} +If @var{locspec} specifies a line number, with or without a file name, +the command deletes any breakpoint with a code location that is at or +within the specified line @var{linenum} in files that match the +specified @var{filename}. If @var{filename} is omitted, it defaults +to the current source file. + +@item *@var{address} +If @var{locspec} specifies an address, the command deletes any +breakpoint with a code location that is at the given @var{address}. =20 -@item clear @var{linenum} -@itemx clear @var{filename}:@var{linenum} -Delete any breakpoints set at or within the code of the specified -@var{linenum} of the specified @var{filename}. +@item @var{function} +@itemx -function @var{function} +If @var{locspec} specifies a function, the command deletes any +breakpoint with a code location that is at the entry to any function +whose name matches @var{function}. @end table =20 +Ambiguity in names of files and functions can be resolved as described +in @ref{Location Specifications}. + @cindex delete breakpoints @kindex delete @kindex d @r{(@code{delete})}