From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id kfq9EeINUGifpRAAWB0awg (envelope-from ) for ; Mon, 16 Jun 2025 08:28:18 -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=FozYvKUu; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 312381E102; Mon, 16 Jun 2025 08:28:18 -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 297951E089 for ; Mon, 16 Jun 2025 08:28:17 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 9FB8E39DA886 for ; Mon, 16 Jun 2025 12:28:16 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9FB8E39DA886 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=FozYvKUu Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 5BA373846E7C for ; Mon, 16 Jun 2025 12:27:12 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 5BA373846E7C 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 5BA373846E7C 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=1750076832; cv=none; b=s1A07Df8idNi6/AlXejUrXKaNaLsGUffmbROnJhe1WMSOiUZ5p8oC5LsFuKpNvt+bnnzgng2Uk1TMydzVyxf91COipx9TgnnaSSaJbahE3Rp34Po/TpWNCmBqrkkKzhSN/dYMQKDeIBtzSOCpoAYedH55sC17N4ZhKMyrTGoYlQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1750076832; c=relaxed/simple; bh=QevyvjPB3Ysk4zVCX55Fw7tV8joziLO4LqL8hC7B3zw=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=U15LHRtYo+rd1RO3cnNqcym2paRNB3ejTI8fILkPFz72hBQq5V0yA53MqXHiOhPYlJlH5UWzfw7VfQQExmS8TwXDQb1sOn/4h/difdMAf1OTTqS8Qw/tQ6LJk45IiUE4/pxUQZP0qJfbUCVHpd9aRCLCS8j2/QiSEksUbRc6EBE= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5BA373846E7C 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 1uR8vf-0006Ii-1r; Mon, 16 Jun 2025 08:27:11 -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=jRyfQyPuj8u0EMsvJcRdjf44lpDPPAfbLuBbSdK3V6o=; b=FozYvKUuDATv /IXaIraNpJMN6qSq1yM0J9oSIcOao4+bYih5QyTS5eT+gsDcfEe+cxgLLYsDSoa7EXWQsqUyagl9C tqlJAfapRhP4/q6FKQNsGQw5C7kfTDX/3zb7lVp9rfQggiGCcgKPL47EkTv+8nGccaKsmJHP/vEFD JPqI3ZpFsUp9D8U7LqNSq+/xXzj4fC2nk4PCVH7dTHPcTI3JZciSY/FIgGfWvSoh1mxbXBI2N27al HObZI/1X/HpWS+ZNWqlG7yQ6XpVFxFFOfFHB1Zprd8eHxwIfnWVhbOCuFrjj0PCQp+Fp58pZwGYrr 9G6Ib9YJhLFiS5sDZTgozA==; Date: Mon, 16 Jun 2025 15:27:04 +0300 Message-Id: <86v7ovoorr.fsf@gnu.org> From: Eli Zaretskii To: Guinevere Larsen Cc: gdb-patches@sourceware.org In-Reply-To: <20250616115521.12950-1-guinevere@redhat.com> (message from Guinevere Larsen on Mon, 16 Jun 2025 08:55:21 -0300) Subject: Re: [PATCH v3] gdb/doc: Explain linker namespaces References: <20250606194533.727963-1-guinevere@redhat.com> <20250616115521.12950-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: Guinevere Larsen > 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