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

[Eli Zaretskii <eliz@gnu.org>]

> From: Guinevere Larsen <guinevere@redhat.com>
> Cc: eliz@gnu.org,
> 	Guinevere Larsen <guinevere@redhat.com>
> Date: Fri,  6 Jun 2025 12:24:23 -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 | 15 +++++++++++----
>  1 file changed, 11 insertions(+), 4 deletions(-)

Thanks.

> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -13106,8 +13106,8 @@ environment variable.
>  
>  @vindex $_active_linker_namespaces@r{, convenience variable}
>  @item $_active_linker_namespaces
> -Number of active linkage namespaces in the inferior.  In systems with no
> -support for linkage namespaces, this variable will always be set to @samp{1}.
> +Number of active linker namespaces in the inferior.  In systems with no
> +support for linker namespaces, this variable will always be set to @samp{1}.

Please add here a cross-reference to where linker namespaces are
described.

> +@cindex Linker Namespaces

Index entries should try not to use upper-case letters, unless really
necessary.  This is because in some locales upper-case letters'
sorting order is different from the US-ASCII locale, and we don't want
the sorting of the index entries depend on the locale where the manual
is produced.

> +Linker namespaces are a feature of some standard libraries, that allow
> +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

Please use ``namespace'', not "namespace".  The former produces
prettier output in the printed version of the manual.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>