[PATCH] Enhance break command help

Andrew STUBBS
2005-12-01T12:28:52Z

[-- Attachment #1: Type: text/plain, Size: 339 bytes --]

Hi,

The attached patch adds more information to the on-line help for the
break command. It adds a brief description how to set thread specific
and conditional breakpoints.

The information is all in the user guide, but was missing from the
internal help message.

This is in response to a complaint from a user.

Thanks

Andrew Stubbs

[-- Attachment #2: break-help.patch --]
[-- Type: text/plain, Size: 1569 bytes --]

2005-12-01 Andrew Stubbs <andrew.stubbs@st.com>

* breakpoint.c (_initialize_breakpoint): Enhance break command help.

Index: src/gdb/breakpoint.c
===================================================================
--- src.orig/gdb/breakpoint.c 2005-12-01 12:05:59.000000000 +0000
+++ src/gdb/breakpoint.c 2005-12-01 12:19:28.000000000 +0000
@@ -7809,13 +7809,17 @@ See also the \"delete\" command which cl

c = add_com ("break", class_breakpoint, break_command, _("\
Set breakpoint at specified line or function.\n\
-Argument may be line number, function name, or \"*\" and an address.\n\
-If line number is specified, break at start of code for that line.\n\
-If function is specified, break at start of code for that function.\n\
+break [LOCATION] [thread THREADNUM] [if CONDITION]\n\
+The LOCATION may be a line number, function name, or \"*\" and an address.\n\
+If a line number is specified, break at start of code for that line.\n\
+If a function is specified, break at start of code for that function.\n\
If an address is specified, break at that exact address.\n\
-With no arg, uses current execution address of selected stack frame.\n\
+With no LOCATION, uses current execution address of selected stack frame.\n\
This is useful for breaking on return to a stack frame.\n\
\n\
+The THREADNUM is the number from \"info threads\".\n\
+The CONDITION is a boolean expression.\n\
+\n\
Multiple breakpoints at one place are permitted, and useful if conditional.\n\
\n\
Do \"help breakpoints\" for info on other commands dealing with breakpoints."));