From 9507b29c0a00fb62f015fe69f82aaf8f5377ab35 Mon Sep 17 00:00:00 2001 From: Tom Tromey Date: Fri, 23 Mar 2018 10:29:28 -0600 Subject: [PATCH] Improve "backtrace" help text This improves help text in stack.c in two ways. First, it removes trailing newlines from various help strings. I think these are never needed. Second, it adds a "Usage" line to the "backtrace" text, as suggested by Pedro. gdb/ChangeLog 2018-03-26 Tom Tromey * stack.c (_initialize_stack): Remove trailing newlines from help text. Add "Usage" line to "backtrace" help. --- gdb/ChangeLog | 5 +++++ gdb/stack.c | 13 +++++++------ 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/gdb/ChangeLog b/gdb/ChangeLog index 05f0c2dc6fa..7699437638a 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,8 @@ +2018-03-26 Tom Tromey + + * stack.c (_initialize_stack): Remove trailing newlines from help + text. Add "Usage" line to "backtrace" help. + 2018-03-26 Tom Tromey PR python/16486: diff --git a/gdb/stack.c b/gdb/stack.c index 16f7931be17..427b182c7f5 100644 --- a/gdb/stack.c +++ b/gdb/stack.c @@ -2554,22 +2554,23 @@ This is useful in command scripts.")); Select and print a stack frame.\nWith no argument, \ print the selected stack frame. (See also \"info frame\").\n\ An argument specifies the frame to select.\n\ -It can be a stack frame number or the address of the frame.\n")); +It can be a stack frame number or the address of the frame.")); add_com_alias ("f", "frame", class_stack, 1); add_com_suppress_notification ("select-frame", class_stack, select_frame_command, _("\ Select a stack frame without printing anything.\n\ An argument specifies the frame to select.\n\ -It can be a stack frame number or the address of the frame.\n"), +It can be a stack frame number or the address of the frame."), &cli_suppress_notification.user_selected_context); add_com ("backtrace", class_stack, backtrace_command, _("\ Print backtrace of all stack frames, or innermost COUNT frames.\n\ -With a negative argument, print outermost -COUNT frames.\nUse of the \ -'full' qualifier also prints the values of the local variables.\n\ +Usage: backtrace [QUALIFIERS]... [COUNT]\n\ +With a negative argument, print outermost -COUNT frames.\n\ +Use of the 'full' qualifier also prints the values of the local variables.\n\ Use of the 'no-filters' qualifier prohibits frame filters from executing\n\ -on this backtrace.\n")); +on this backtrace.")); add_com_alias ("bt", "backtrace", class_stack, 0); add_com_alias ("where", "backtrace", class_alias, 0); @@ -2587,7 +2588,7 @@ on this backtrace.\n")); if (dbx_commands) add_com ("func", class_stack, func_command, _("\ Select the stack frame that contains .\n\ -Usage: func \n")); +Usage: func ")); add_setshow_enum_cmd ("frame-arguments", class_stack, print_frame_arguments_choices, &print_frame_arguments, -- 2.30.2