gdb/cli: fixes to newly added "list ." command
authorGuinevere Larsen <blarsen@redhat.com>
Tue, 19 Sep 2023 12:06:49 +0000 (14:06 +0200)
committerGuinevere Larsen <blarsen@redhat.com>
Tue, 19 Sep 2023 12:06:49 +0000 (14:06 +0200)
After the series that added this command was pushed, Pedro mentioned
that the news description could easily be misinterpreted, as well as
some code and test improvements that should be made.

While fixing the test, I realized that code repetition wasn't
happening as it should, so I took care of that too.

Approved-By: Andrew Burgess <aburgess@redhat.com>
Reviewed-By: Eli Zaretskii <eliz@gnu.org>
gdb/NEWS
gdb/cli/cli-cmds.c
gdb/doc/gdb.texinfo
gdb/testsuite/gdb.base/list.exp

index 98ff00d5efc3d85cd52c10f2ccc1866ea6232d84..bb9d26abf6b20c457661188d0690fc2fb5456577 100644 (file)
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -90,8 +90,9 @@
   expression parser.
 
 * The 'list' command now accepts '.' as an argument, which tells GDB to
-  print the location where the inferior is stopped.  If the inferior hasn't
-  started yet, the command will print around the main function.
+  print the location around the point of execution within the current frame.
+  If the inferior hasn't started yet, the command will print around the
+  beginning of the 'main' function.
 
 * Using the 'list' command with no arguments in a situation where the
   command would attempt to list past the end of the file now warns the
index 0fa24fd3df982774b6c7bf58b7929d4f3ab60049..b801e210d6e08a7a84758e5593d381c8722ba155 100644 (file)
@@ -1272,10 +1272,10 @@ list_command (const char *arg, int from_tty)
          print_source_lines (cursal.symtab, range, 0);
        }
 
-      /* "l ." lists the default location again.  */
+      /* "list ." lists the default location again.  */
       else if (arg[0] == '.')
        {
-         try
+         if (target_has_stack ())
            {
              /* Find the current line by getting the PC of the currently
                 selected frame, and finding the line associated to it.  */
@@ -1283,19 +1283,19 @@ list_command (const char *arg, int from_tty)
              CORE_ADDR curr_pc = get_frame_pc (frame);
              cursal = find_pc_line (curr_pc, 0);
            }
-         catch (const gdb_exception &e)
+         else
            {
-             /* If there was an exception above, it means the inferior
-                is not running, so reset the current source location to
-                the default.  */
+             /* The inferior is not running, so reset the current source
+                location to the default (usually the main function).  */
              clear_current_source_symtab_and_line ();
              set_default_source_symtab_and_line ();
              cursal = get_current_source_symtab_and_line ();
            }
          list_around_line (arg, cursal);
-         /* Advance argument so just pressing "enter" after using "list ."
+         /* Set the repeat args so just pressing "enter" after using "list ."
             will print the following lines instead of the same lines again. */
-         arg++;
+         if (from_tty)
+           set_repeat_arguments ("");
        }
 
       return;
@@ -2805,9 +2805,9 @@ and send its output to SHELL_COMMAND."));
     = add_com ("list", class_files, list_command, _("\
 List specified function or line.\n\
 With no argument, lists ten more lines after or around previous listing.\n\
-\"list .\" lists ten lines arond where the inferior is stopped.\n\
 \"list +\" lists the ten lines following a previous ten-line listing.\n\
 \"list -\" lists the ten lines before a previous ten-line listing.\n\
+\"list .\" lists ten lines around the point of execution in the current frame.\n\
 One argument specifies a line, and ten lines are listed around that line.\n\
 Two arguments with comma between specify starting and ending lines to list.\n\
 Lines can be specified in these ways:\n\
index aa3c677888716aed54671bef8cb4960987e1df6a..5db30bf4a71e422fd392da87d1c0501b0db8ab62 100644 (file)
@@ -9212,9 +9212,9 @@ Same as using with no arguments.
 Print lines just before the lines last printed.
 
 @item list .
-Print the lines surrounding the location that is where the inferior
-is stopped.  If the inferior is not running, print around the main
-function instead.
+Print the lines surrounding the point of execution within the
+currently selected frame.  If the inferior is not running, print lines
+around the start of the main function instead.
 @end table
 
 @cindex @code{list}, how many lines to display
index 582355996b0870f38d8e92d782eb4edf3eeb0da0..306fe41c3a3200e33907f15032f531efaf95690f 100644 (file)
@@ -402,18 +402,15 @@ proc test_list_invalid_args {} {
 
 proc test_list_current_location {} {
     global binfile
-    # If the first "list" command that GDB runs is "list ." GDB may be
-    # unable to recognize that the inferior isn't running, so we should
-    # reload the inferior to test that condition.
-    clean_restart
+    # Reload the inferior to test "list ." before the inferior is started.
     gdb_file_cmd ${binfile}
 
-    # Ensure that we are printing 10 lines
+    # Ensure that we are printing 10 lines.
     if {![set_listsize 10]} {
        return
     }
 
-    # First guarantee that GDB prints around the main function correctly
+    # First guarantee that GDB prints around the main function correctly.
     gdb_test "list ." \
        "1.*\r\n2\[ \t\]+\r\n3\[ \t\]+int main \[)(\]+.*5\[ \t\]+int x;.*" \
        "list . with inferior not running"
@@ -423,17 +420,22 @@ proc test_list_current_location {} {
        return
     }
 
-    # Walk forward some lines
+    # Walk forward some lines.
     gdb_test "until 15" ".*15.*foo.*"
 
     # Test that the correct location is printed and that
     # using just "list" will print the following lines.
-    gdb_test "list ." ".*" "list current line after starting"
-    gdb_test "list" ".*" "confirm we are printing the following lines"
+    gdb_test "list ." "10\[ \t\]+foo \(.*\);.*19\[ \t\]+foo \(.*\);" \
+       "list current line after starting"
+    gdb_test "list" "20\[ \t\]+foo \(.*\);.*29\[ \t\]+foo \(.*\);" \
+       "confirm we are printing the following lines"
 
     # Test that list . will reset to current location
-    gdb_test "list ." ".*" "list around current line again"
-    gdb_test " " ".*" "testing repeated invocations with GDB's auto-repeat"
+    # and that an empty line lists the following lines.
+    gdb_test "list ." "10\[ \t\]+foo \(.*\);.*19\[ \t\]+foo \(.*\);" \
+       "list around current line again"
+    gdb_test " " "20\[ \t\]+foo \(.*\);.*29\[ \t\]+foo \(.*\);" \
+       "testing repeated invocations with GDB's auto-repeat"
 }
 
 clean_restart