From ae60f04e08bf48f65d9101a6ab63f3806e6fca5e Mon Sep 17 00:00:00 2001
From: Philippe Waroquiers <philippe.waroquiers@skynet.be>
Date: Sat, 3 Aug 2019 21:20:44 +0200
Subject: [PATCH] NEWS and documentation for info sources [-dirname |
-basename] [--] [REGEXP].
gdb/ChangeLog
2019-08-03 Philippe Waroquiers <philippe.waroquiers@skynet.be>
* NEWS: Mention changes to "info sources" command.
gdb/doc/ChangeLog
2019-08-03 Philippe Waroquiers <philippe.waroquiers@skynet.be>
* gdb.texinfo (Symbols): Document new args -dirname and -basename
of "info sources" command.
---
gdb/ChangeLog | 4 ++++
gdb/NEWS | 9 +++++++++
gdb/doc/ChangeLog | 5 +++++
gdb/doc/gdb.texinfo | 10 ++++++++++
4 files changed, 28 insertions(+)
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index a5c89420374..71f1691da04 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,7 @@
+2019-08-03 Philippe Waroquiers <philippe.waroquiers@skynet.be>
+
+ * NEWS: Mention changes to "info sources" command.
+
2019-08-03 Philippe Waroquiers <philippe.waroquiers@skynet.be>
* symtab.c (filename_partial_match_opts): New struct type.
diff --git a/gdb/NEWS b/gdb/NEWS
index 3c3351e2c47..da641cb5980 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -144,6 +144,12 @@ eval
This allows to do formatted printing of strings without having
a running inferior, or when debugging a core dump.
+info sources [-dirname | -basename] [--] [REGEXP]
+ This command has now optional arguments to only print the files
+ whose names match REGEXP. The arguments -dirname and -basename
+ allow to restrict matching respectively to the dirname and basename
+ parts of the files.
+
show style
The "show style" and its subcommands are now styling
a style name in their output using its own style, to help
@@ -225,6 +231,9 @@ maint show test-options-completion-result
-past-main [on|off]
-past-entry [on|off]
+ ** The new "info sources" options -dirname and -basename options
+ are using the standard '-OPT' infrastructure.
+
All options above can also be abbreviated. The argument of boolean
(on/off) options can be 0/1 too, and also the argument is assumed
"on" if omitted. This allows writing compact command invocations,
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index e469b6057d7..95fd22cddd0 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2019-08-03 Philippe Waroquiers <philippe.waroquiers@skynet.be>
+
+ * gdb.texinfo (Symbols): Document new args -dirname and -basename
+ of "info sources" command.
+
2019-07-30 Christian Biesinger <cbiesinger@google.com>
* python.texi (Symbols In Python): Document new function
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 0fcd131f71e..89b1eda2c17 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -18583,6 +18583,16 @@ Print the names of all source files in your program for which there is
debugging information, organized into two lists: files whose symbols
have already been read, and files whose symbols will be read when needed.
+@item info sources [-dirname | -basename] [--] [@var{regexp}]
+Like @samp{info sources}, but only print the names of the files
+matching the provided @var{regexp}.
+By default, the @var{regexp} is used to match anywhere in the filename.
+If @code{-dirname}, only files having a dirname matching @var{regexp} are shown.
+If @code{-basename}, only files having a basename matching @var{regexp}
+are shown.
+The matching is case-sensitive, except on operating systems that
+have case-insensitive filesystem (e.g., MS-Windows).
+
@kindex info functions
@item info functions [-q]
Print the names and data types of all defined functions.