* utils.c (initialize_utils): Improve doc strings of "set/show

	width", "set/show height", and "set/show pagination".

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 4dd15407ff324eacf21fd3bde2a32dcebdd7546a..981a6268d5eac9f95512d583f00031e75b6239a7 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,4 +1,8 @@
-ChangeLog
+2013-03-07  Eli Zaretskii  <eliz@gnu.org>
+
+       * utils.c (initialize_utils): Improve doc strings of "set/show
+       width", "set/show height", and "set/show pagination".
+
 2013-03-06  Keith Seitz  <keiths@redhat.com>
 
        * ax-gdb.c (gen_printf): Make FORMAT const.

diff --git a/gdb/utils.c b/gdb/utils.c
index eb99f4b161ea086b4a1173064979d1b8180c03ca..6065d8221b3f7dc476acd165e3b925c3cf60bf4b 100644 (file)
--- a/gdb/utils.c
+++ b/gdb/utils.c
@@ -2732,15 +2732,20 @@ void
 initialize_utils (void)
 {
   add_setshow_uinteger_cmd ("width", class_support, &chars_per_line, _("\
-Set number of characters gdb thinks are in a line."), _("\
-Show number of characters gdb thinks are in a line."), NULL,
+Set number of characters where GDB should wrap lines of its output."), _("\
+Show number of characters where GDB should wrap lines of its output."), _("\
+This affects where GDB wraps its output to fit the screen width.\n\
+Setting this to zero prevents GDB from wrapping its output."),
                            set_width_command,
                            show_chars_per_line,
                            &setlist, &showlist);
 
   add_setshow_uinteger_cmd ("height", class_support, &lines_per_page, _("\
-Set number of lines gdb thinks are in a page."), _("\
-Show number of lines gdb thinks are in a page."), NULL,
+Set number of lines in a page for GDB output pagination."), _("\
+Show number of lines in a page for GDB output pagination."), _("\
+This affects the number of lines after which GDB will pause\n\
+its output and ask you whether to continue.\n\
+Setting this to zero causes GDB never pause during output."),
                            set_height_command,
                            show_lines_per_page,
                            &setlist, &showlist);
@@ -2749,8 +2754,11 @@ Show number of lines gdb thinks are in a page."), NULL,
 
   add_setshow_boolean_cmd ("pagination", class_support,
                           &pagination_enabled, _("\
-Set state of pagination."), _("\
-Show state of pagination."), NULL,
+Set state of GDB output pagination."), _("\
+Show state of GDB output pagination."), _("\
+When pagination is ON, GDB pauses at end of each screenful of\n\
+its output and asks you whether to continue.\n\
+Turning pagination off is an alternative to \"set height 0\"."),
                           NULL,
                           show_pagination_enabled,
                           &setlist, &showlist);