From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id INWECYhIQ2gFpQMAWB0awg (envelope-from ) for ; Fri, 06 Jun 2025 15:59:04 -0400 Authentication-Results: simark.ca; dkim=pass (2048-bit key; unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=Wi1Fac43; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 14CE61E11C; Fri, 6 Jun 2025 15:59:04 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-10.1 required=5.0 tests=ARC_SIGNED,ARC_VALID, BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,RCVD_IN_VALIDITY_CERTIFIED, RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE autolearn=ham autolearn_force=no version=4.0.1 Received: from server2.sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id E40BD1E0C2 for ; Fri, 6 Jun 2025 15:59:02 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 664F43856DF0 for ; Fri, 6 Jun 2025 19:59:02 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 664F43856DF0 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=Wi1Fac43 Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 442DC3857B84 for ; Fri, 6 Jun 2025 19:58:30 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 442DC3857B84 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 442DC3857B84 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:142:3::10 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1749239910; cv=none; b=EOkklJmogA4nRMDeacKqHUmlalPXRDhFHM4ZvYak8U4xVQQlfA+XtWHucBsCHViTqUbSXXoeFemw3AncZmj4rsrtOzUZQjO+kEskoDP3ubLDW33ssLBKUss8TbuBCiN9r1RMzu3pzpg7aIiyQxMscs6/KloWSl9nTMoEWFPCzCU= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1749239910; c=relaxed/simple; bh=zvCAvilh9/kgnliwxnIBkK89oS5HcXm+8bwUjygSCSc=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=vClD2tlcVgvD5W7H5EaT5yepkv3M76UQBv8kdpUiUcrTvMv4BwYqwKFN82p+wiRwsWHDZ15dbr7zG2qs3d+6QK5AyNMyrNKCmKyajdMHTObDkCvpT4Vw6ZHOs14BR4IQYQLIil1ZseC2HwecKqj5nAJnk3mvizysjEFI8ljrY7M= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 442DC3857B84 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uNdCv-0000wB-GT; Fri, 06 Jun 2025 15:58:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=Kv6YtH7uVA6a5NptYtgJPaX1AmGEgQsiaZCiHjCgbjo=; b=Wi1Fac43HdRB +F7QvO5kJCWn35IZgDLebHuJ8GAgbfeEj/4bTVXSKoIIwxZ8mT1jaJClCUHsk1Y4MI3wT9QnkxTml oeRbpkq1Xs7ANE8qLoYMNdTA6X85qHnfVPU4RZZGiFGEY1iNC1+JrEMUsQkN1PR3TxnDVcJO+8ERp oqLO3EO3WmyYr0FUyy3VGYUa+bhQwKHApIlurFCsZFFtRn0lBPAiRwgUUKa7U/L8ixvLjbK2AJZY2 +XUsF/EECITCfXCKw7BpvRLbmIQbk4rGfMe8QjHuqDoUQSu3ntykJznGmgNJKc0VCwTurzxXWQJ4+ 7dEWfbAMliZ7htpqOA5WfQ==; Date: Fri, 06 Jun 2025 22:58:26 +0300 Message-Id: <867c1olk0t.fsf@gnu.org> From: Eli Zaretskii To: Guinevere Larsen Cc: gdb-patches@sourceware.org In-Reply-To: <20250606194533.727963-1-guinevere@redhat.com> (message from Guinevere Larsen on Fri, 6 Jun 2025 16:45:33 -0300) Subject: Re: [PATCH v2] gdb/doc: Explain linker namespaces References: <20250606152423.567047-1-guinevere@redhat.com> <20250606194533.727963-1-guinevere@redhat.com> X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org > From: Guinevere Larsen > Cc: eliz@gnu.org, > Guinevere Larsen > 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