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

[Eli Zaretskii <eliz@gnu.org>]

> 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>