From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id BTOPAz84Q2iPlQMAWB0awg (envelope-from ) for ; Fri, 06 Jun 2025 14:49:35 -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=gGXq22ZD; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id EE8461E11C; Fri, 6 Jun 2025 14:49:34 -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 30B9C1E0C2 for ; Fri, 6 Jun 2025 14:49:34 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id F116B385771D for ; Fri, 6 Jun 2025 18:49:32 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org F116B385771D 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=gGXq22ZD Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id CF6953858C50 for ; Fri, 6 Jun 2025 18:48:46 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org CF6953858C50 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 CF6953858C50 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=1749235726; cv=none; b=jnm+FOd3T6Rw9VQGDhshLJ37RByjEcFJdCLprcKnw/llXaB+1ynvT4Kh16zIowLqmGteMjkie/UxjufMAFsFYFoN+ByjfbiGuvIZTZwQGLFm3PSjJIQUOrBLedwvxxFpB9oPa438Qd6jBfsTp+0hL8qqpgWIUSFBo8o+Gj3v+j0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1749235726; c=relaxed/simple; bh=9WF8UAwS+t5UtNnlDqm5wyi/+RPU5qZL4TgRvAaXnds=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=W8oh6vMgUQvFVoy6IKsSuGhHWDH2heHCV9IZAe/bRBVVC0yu8cfHEwnqLbBrW9vFskXS1NwW+EkkRxNjH2bXhkK0Mi+9ShFqmkTrlPK7lh1Zfk2zuPKgpMajZql2Ba+QNhm885NUl/MqwjAhth5PvN/oZ4yTokkKpYpmSxcx7nc= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org CF6953858C50 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 1uNc7S-00017V-CH; Fri, 06 Jun 2025 14:48:46 -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=1rB2dB7vRWP4xs+ouNb2KW+KZw8FTA+diym8w92D+Rw=; b=gGXq22ZDG3rN CSCUY2O407PXnf8m1vIKjc754PDX2bfugbBhmVy0ZFxk8HqH0t/4GIREbXoH6s/CDTLisAVPw5N0s 6buaYqOT4XlUdOYSyGanUGWjPfaGGhE4nix4gOrJlBfdjQtFg0M1sgAR8BicrKnQdpNbRgnzgviK3 FAhiybpW08dXuEuD9/Iqwj49Ei43gcDhPro8i3NpA3Ac/W1fiROq5YLYgQTaTQ94SpeTmPz4I1Cri bCVN0q1cApodTJQI6h7VAIegH0WvhfQxdFEqOAgrS9lNrFCliWJgIvoAMelwxbbrLVlMeEdVKFIlQ ndZ6ZoCmSymJKalq697Dsw==; Date: Fri, 06 Jun 2025 21:48:44 +0300 Message-Id: <86frgcln8z.fsf@gnu.org> From: Eli Zaretskii To: Guinevere Larsen Cc: gdb-patches@sourceware.org In-Reply-To: <20250606152423.567047-1-guinevere@redhat.com> (message from Guinevere Larsen on Fri, 6 Jun 2025 12:24:23 -0300) Subject: Re: [PATCH] gdb/doc: Explain linker namespaces References: <20250606152423.567047-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 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