From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id jIVqGzZ8UGihHBEAWB0awg (envelope-from ) for ; Mon, 16 Jun 2025 16:19:02 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=cWzxERsl; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 5F4121E11C; Mon, 16 Jun 2025 16:19:02 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.8 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_SBL_CSS,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 CAF221E0C2 for ; Mon, 16 Jun 2025 16:19:01 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 4FF3B385023A for ; Mon, 16 Jun 2025 20:19:01 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4FF3B385023A Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=cWzxERsl Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTP id EE657385F01D for ; Mon, 16 Jun 2025 20:18:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org EE657385F01D Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org EE657385F01D Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1750105084; cv=none; b=pMpLluWjACl6qaGzK+kW86VYUBnQg4D5VssbGS7C3VpWJuaI5PStERqaNKL12ywKV4stNWqAY7yVe5dPrs9So17yUWYJ3P6AnVey1IpNoi4XtmgdtIrJG0unEAR1plAEX22x/CBS2UZefgmMlrk85UQeNbQKjGBLGHoM2uwqMJc= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1750105084; c=relaxed/simple; bh=YUIHKf72BjkcwLk9S4GwfyD649AzXMWXpGt2OCIgIao=; h=DKIM-Signature:Message-ID:Date:MIME-Version:Subject:To:From; b=fqYVN6QEJOde3MCqVWEYMfNDj8Z+0hUwfOKOawVjc7p36GtYFe1hsnAEzr9qSFRUcNXrvq+1pAw7tmG9eCQh5904RfiF4bmq9HWi341gfNVzXzkXdx4y1c+ZOHU0RA7G+l0oXJRlDT9L2CLKttZlv8G3Q9x0ig+1ckcIWs8jUXQ= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org EE657385F01D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1750105083; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZsH/Gb8qJGUI4fXp5D/HPGKhUVTzz0kdQs2V+VdzPYU=; b=cWzxERsliTLQ9jqNdFyILWlpfF68B7MEKoIuYh1MXkMTQmEEo3SpuD/rIDDKpYZZwm1nIj Jc2QPOCL5PDBZrH5Zz2bHpR8SV2R2tpABCM1gGX/XQN/uU7B5zKqJYDVBeJbSoEAz6s/sJ Tub7e2lpyTF3a4YCDQVx1NIMJTkNglA= Received: from mail-qv1-f71.google.com (mail-qv1-f71.google.com [209.85.219.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-693-5uHm7Wi4PoK8fqe4DOHJfA-1; Mon, 16 Jun 2025 16:18:02 -0400 X-MC-Unique: 5uHm7Wi4PoK8fqe4DOHJfA-1 X-Mimecast-MFC-AGG-ID: 5uHm7Wi4PoK8fqe4DOHJfA_1750105082 Received: by mail-qv1-f71.google.com with SMTP id 6a1803df08f44-6fad9167e4cso103441506d6.1 for ; Mon, 16 Jun 2025 13:18:02 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750105082; x=1750709882; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=ZsH/Gb8qJGUI4fXp5D/HPGKhUVTzz0kdQs2V+VdzPYU=; b=EMPZaDi9J/G6d7q+YdX7kzMN0WrSY9JCMDjq3HiyJiyseJavJqSynurr/iCUHrvWf9 Idb7Ky15vTO+Hvyso8StqTtu07slbYJ14qnyzYM149JgeIhb4vjzwFxsG0G5K86FUF8N 7ow+v83rLMRlCuDzOP6dQzV6bmmnat3ClB3H3Q4og2TvMEbPma/wa7T4rED1sTqKiv7g k2yeOQRqNiiwo1i1AfQW1+Etk/aqCiBsvyJYMDtvj5ub5Vj1eBu7tGKZCKgREugloLjx zAnBfxqyrB596/JKMwvnRhAVOFKzIR4NzFZYfUkAVVWjM+zXcrTLcXpFTBGImZ1g6ZSo uzag== X-Gm-Message-State: AOJu0YwI+htxriTijjjLM6mJVxRkozBz0koHdvBsv+7F8zfrWnwbigp7 zr5roo1l4QljMq92KZ6ZMb4VwwBGak7w0t4vPR1xxC8Fb1d+jWufM3656ibRWpuuBEDoJ/vm+8N yCslPhtifgZWES1Jhm7iHMNMlQpKqlxwTF/bWnQkNDeqpn7PZs8iiCMbXGqKDvPusR1y31L8= X-Gm-Gg: ASbGncslQYOleTSDbZZcsAq9COB0/qkN7Hkmi6gbCqVFftoTUTnU4RJiHuSCjMvDapk osG0Ur4qgExOrrjoTGNmBpyYHqU6UfbR/Ou/A+IzRsr2T8v502uNpyuSuf7KaEXS3ulyO157P9j 5pJGsZup2MFYzUZCBaMctjuLNsfGWouJUy4bO0NkJesMgcnt+/XGjPinvEkduI1vMV4Vh1p9lKY VgJBNqwM8Ec0y0SKzPwrdZ9+VRMFqW07As+u1q/+fk/9Q4CB/2HvWRRm+SmX9K6irk6V6P+MFVP dRnd46SKBibj5K6KpPzbhxG5uHCBou1DhQ== X-Received: by 2002:a05:6214:224b:b0:6fa:fb7d:6e4c with SMTP id 6a1803df08f44-6fb477d990dmr166789486d6.25.1750105081943; Mon, 16 Jun 2025 13:18:01 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGAETsKtTYjs3wXs58kFfjRPATcwRK8Lg2dabcbOEd9URhC3yMv9k4D4nLdNGRm1w9zto54ow== X-Received: by 2002:a05:6214:224b:b0:6fa:fb7d:6e4c with SMTP id 6a1803df08f44-6fb477d990dmr166789056d6.25.1750105081443; Mon, 16 Jun 2025 13:18:01 -0700 (PDT) Received: from ?IPV6:2804:14d:8084:9a69::1000? ([2804:14d:8084:9a69::1000]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6fb35c84148sm54919116d6.109.2025.06.16.13.18.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 16 Jun 2025 13:18:01 -0700 (PDT) Message-ID: <4ec822b2-5639-4bed-8f81-c9692907f364@redhat.com> Date: Mon, 16 Jun 2025 17:17:59 -0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3] gdb/doc: Explain linker namespaces To: Eli Zaretskii Cc: gdb-patches@sourceware.org References: <20250606194533.727963-1-guinevere@redhat.com> <20250616115521.12950-1-guinevere@redhat.com> <86v7ovoorr.fsf@gnu.org> From: Guinevere Larsen In-Reply-To: <86v7ovoorr.fsf@gnu.org> X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: qC1zw8_cfSUGAc8KgrmPWAG43j-DZCjcbBqoDaRWaSk_1750105082 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit 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 On 6/16/25 9:27 AM, Eli Zaretskii wrote: >> 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 > Thanks for the review, I've pushed this patch with the fixes -- Cheers, Guinevere Larsen She/Her/Hers