Add "usage" text to all TUI command help

This adds "usage" text to the help for all all the TUI commands.  In
some cases the usage is borderline, but I tend to think being complete
is preferable.

2020-02-22  Tom Tromey  <tom@tromey.com>

	* tui/tui-win.c (_initialize_tui_win): Add usage text.
	* tui/tui-stack.c (_initialize_tui_stack): Add usage text.
	* tui/tui-regs.c (_initialize_tui_regs): Add usage text.
	* tui/tui.c (_initialize_tui): Add usage text.

Change-Id: I727f7a7cfc03efa248ef98f30a18be393819e30b

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 059e9cdb199733f9527304bd441df7c5533f9ad0..f45b740cb7a06c6b3b141454466831541a18e4b4 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,10 @@
+2020-02-22  Tom Tromey  <tom@tromey.com>
+
+       * tui/tui-win.c (_initialize_tui_win): Add usage text.
+       * tui/tui-stack.c (_initialize_tui_stack): Add usage text.
+       * tui/tui-regs.c (_initialize_tui_regs): Add usage text.
+       * tui/tui.c (_initialize_tui): Add usage text.
+
 2020-02-22  Tom Tromey  <tom@tromey.com>
 
        * tui/tui-win.c (tui_set_focus_command)

diff --git a/gdb/tui/tui-regs.c b/gdb/tui/tui-regs.c
index 7858236ddcb2ccba3515b4fa977e454305820db4..d33f0aadef8253fd15f88b705bd000d246686c0c 100644 (file)
--- a/gdb/tui/tui-regs.c
+++ b/gdb/tui/tui-regs.c
@@ -654,6 +654,8 @@ _initialize_tui_regs ()
   tuicmd = tui_get_cmd_list ();
 
   cmd = add_cmd ("reg", class_tui, tui_reg_command, _("\
-TUI command to control the register window."), tuicmd);
+TUI command to control the register window.\n\
+Usage: tui reg NAME\n\
+NAME is the name of the register group to display"), tuicmd);
   set_cmd_completer (cmd, tui_reggroup_completer);
 }

diff --git a/gdb/tui/tui-stack.c b/gdb/tui/tui-stack.c
index 7758f2f40d59c978bda487ddcbd8ac97e6c1a856..f1e075a3d20c1a85ed9f43714c5a90da56f4611e 100644 (file)
--- a/gdb/tui/tui-stack.c
+++ b/gdb/tui/tui-stack.c
@@ -376,5 +376,6 @@ _initialize_tui_stack ()
 {
   add_com ("update", class_tui, tui_update_command,
           _("Update the source window and locator to "
-            "display the current execution point."));
+            "display the current execution point.\n\
+Usage: update"));
 }

diff --git a/gdb/tui/tui-win.c b/gdb/tui/tui-win.c
index dad3464ae19a78999bd68b2698772981e167edbc..b962e028f8e3e05364a42b5c93a55d4f8617f663 100644 (file)
--- a/gdb/tui/tui-win.c
+++ b/gdb/tui/tui-win.c
@@ -1035,7 +1035,8 @@ Use \"info win\" to see the names of the windows currently being displayed."));
   add_com_alias ("wh", "winheight", class_tui, 0);
   set_cmd_completer (cmd, winheight_completer);
   add_info ("win", tui_all_windows_info,
-           _("List of all displayed windows."));
+           _("List of all displayed windows.\n\
+Usage: info win"));
   cmd = add_com ("focus", class_tui, tui_set_focus_command, _("\
 Set focus to named window or next/prev window.\n\
 Usage: focus [WINDOW-NAME | next | prev]\n\

diff --git a/gdb/tui/tui.c b/gdb/tui/tui.c
index 77d7c9068373a6fc7c58b8376e03e80a0e22334f..ac435d16d6cdb510353619df11fdf50c9a87996e 100644 (file)
--- a/gdb/tui/tui.c
+++ b/gdb/tui/tui.c
@@ -562,9 +562,11 @@ _initialize_tui ()
   tuicmd = tui_get_cmd_list ();
 
   add_cmd ("enable", class_tui, tui_enable_command,
-          _("Enable TUI display mode."),
+          _("Enable TUI display mode.\n\
+Usage: tui enable"),
           tuicmd);
   add_cmd ("disable", class_tui, tui_disable_command,
-          _("Disable TUI display mode."),
+          _("Disable TUI display mode.\n\
+Usage: tui disable"),
           tuicmd);
 }