Re: [PATCH v2] 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 16:45:33 -0300
> 
> -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(@pxref{Files}).  In systems
                                                    ^^
Please leave a space before the open paren there.  These parentheses
are output to the formatted manual, so they need to adhere to rules of
English.

>  @vindex $_linker_namespace@r{, convenience variable}
>  @item $_linker_namespace
> -The namespace which contains the current location in the inferior.  This
> -returns @value{GDBN}'s internal numbering for the namespace.  In systems with no
> -support for linker namespaces, this variable will always be set to
> +The namespace which contains the current location in the inferior(@pxref{Files}).
                                                                    ^^^^^^^^^^^^^
There's no need to have the @pxref here, since we just had a cross
reference a dozen lines above.

> @@ -22286,10 +22294,10 @@ conditions or commands as a catchpoint does.
>  @item info linker-namespaces
>  @item info linker-namespaces @code{[[@var{n}]]}
>  
> -With no argument, print the number of linker namespaces which are
> -currently active --- that is, namespaces that have libraries loaded
> -into them.  Then, it prints the number of libraries loaded into each
> -namespace, and all the libraries loaded into them, in the same way
> +With no argument, print the number of linker namespaces (@pxref{Files})

Likewise here: the reference is to the same node as the one in which
this text appears, so there's no need to have a cross-reference here.

Thanks.

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