Re: [PATCH v3] gdb/doc: Explain linker namespaces

[Guinevere Larsen <guinevere@redhat.com>]

On 6/16/25 9:27 AM, Eli Zaretskii wrote:
>> From: Guinevere Larsen <guinevere@redhat.com>
>> Cc: Guinevere Larsen <guinevere@redhat.com>
>> Date: Mon, 16 Jun 2025 08:55:21 -0300
>>
>> Recent GDB commits added more features related to linker namespaces and
>> documented them on the manual, but did not add a convenient way for a
>> user to understand what they are. This commit adds a quick explanation
>> of what they are.
>>
>> It also fixes the inconsistency of using "linker namespaces" and
>> "linkage namespaces", by always using the first form to avoid user
>> confusion.
>> ---
>>   gdb/doc/gdb.texinfo | 23 +++++++++++++++--------
>>   1 file changed, 15 insertions(+), 8 deletions(-)
> Thanks, this is okay, with two minor comments:
>
>> +@cindex linker namespaces
>> +Linker namespaces are a feature of some standard libraries, that allow
> Please enclose "Linker namespaces" in @dfn, as this text introduces
> new terminology.
>
>> +shared objects to be loaded in isolated environment, eliminating the
>> +possibility that those objects may cross-talk.  Each set of isolated
>> +shared objects is said to belong to a "namespace", and linker related
> The "namespace" part should be quote ``like this'', i.e. with single
> quoting characters -- this will produce nicer results in the printed
> output.
>
> Approved-By: Eli Zaretskii <eliz@gnu.org>
>
Thanks for the review, I've pushed this patch with the fixes

-- 
Cheers,
Guinevere Larsen
She/Her/Hers