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

[Pedro Alves <pedro@palves.net>]

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