[PATCH] Explicitly mention yet-unloaded shared libraries in location spec examples

Pedro Alves
2022-05-31T11:14:10Z

On 2022-05-30 17:15, Eli Zaretskii wrote:
>>>> +Here are examples of typical situations that result in a location spec
>>>> +matching multiple concrete code locations in your program:
>>> Should we also enumerate some situations where a location spec cannot
>>> be completely resolved? The text talks about that possibility, but
>>> only in passing, with no details or practical examples.
>> I've added these examples under the multi-location examples:
>>
>> +And here are examples of typical situations that result in a location
>> +spec matching no code locations in your program at all:
>> +
>> +@itemize @bullet
>> +@item
>> +The location spec specifies a function name, and there are no
>> +functions in the program with that name.
>> +
>> +@item
>> +The location spec specifies a source file name, and there are no
>> +source files in the program with that name.
>> +
>> +@item
>> +The location spec specifies both a source file name and a source line
>> +number, and even though there are source files in the program that
>> +match the file name, none of those files has the specified line
>> +number.
>> +@end itemize
> Shouldn't this mention explicitly the frequent situation where the
> location specifies something in a yet-unloaded shared library?
>

Maybe. How about this.

From 4fc52ddcdf871c365a3abc6f681fb79ac473728a Mon Sep 17 00:00:00 2001
From: Pedro Alves <pedro@palves.net>
Date: Tue, 31 May 2022 12:06:50 +0100
Subject: [PATCH] Explicitly mention yet-unloaded shared libraries in location
spec examples

Change-Id: I05639ddb3bf620c7297b57ed286adc3aa926b7b6
---
gdb/doc/gdb.texinfo | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index b497901473d..7886f3eb3dd 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -9150,11 +9150,13 @@ spec matching no code locations in your program at all:
@itemize @bullet
@item
The location spec specifies a function name, and there are no
-functions in the program with that name.
+functions in the program with that name, or they only exist in a
+yet-unloaded shared library.

@item
The location spec specifies a source file name, and there are no
-source files in the program with that name.
+source files in the program with that name, or they only exist in a
+yet-unloaded shared library.

@item
The location spec specifies both a source file name and a source line

base-commit: 5541bfdc97936581c0ead915e9117e22f21bdb12
prerequisite-patch-id: 02daf94a0a458024d52b3a10e80608fd3e26738a
--
2.36.0