From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id POB7CCCrjGrxoj0AWB0awg (envelope-from ) for ; Mon, 24 Aug 2026 16:35:44 -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=MVnSGUh5; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 0947A1E0A3; Mon, 24 Aug 2026 16:35:44 -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.4 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 autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [IPv6:2620:52:6:3111::32]) (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 A0BEE1E033 for ; Mon, 24 Aug 2026 16:35:41 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 6243F4B9DB4B for ; Mon, 24 Aug 2026 20:35:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6243F4B9DB4B 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=MVnSGUh5 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 01CD44BA23DB for ; Mon, 24 Aug 2026 20:35:13 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 01CD44BA23DB 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 01CD44BA23DB Authentication-Results: sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1787603714; cv=none; b=k5pAVzsvz9aCU8pRAsX0PWvR5XcpT3v8DaQTL4W4W3HmQ3K3t1XevjSSarnWV1yLrkLTXZwRB43DgmO+2LfYYzM8ByDhvPdxQg6VS6zj+PpvEODCCpX5YtPnYDNXtZweefGQIjssEkvoLtg13lZFgU93euGMZxxxyvyv88yF2zQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1787603714; c=relaxed/simple; bh=WNtzpVzMYNVgUKGMq+HlMllvhZHQ9A2HLj2VIAx4n2Y=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=D0C1ebBhg+4B6KO55T0oMeVTXe/ulqgeByHCH72n7OQ8EJThKbuW0qBPUz8l0AFSAZK4mllEkVp165uurDfL9rtyYtNUvuq/QWcNe5Iut90v9jelTF+76apvHNSkqtb8xg+wqPMIUZf/6HJYS3ujwymrRELbF9ej4h0l/O1UPo0= ARC-Authentication-Results: i=1; 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=MVnSGUh5 DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 01CD44BA23DB DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1787603713; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=xF5sZeAXwZD+/ZPrGJeJEy+40g6EhVdFb+0JKdWdnpk=; b=MVnSGUh5Ltflqxo/3ifWITd3PMzlB1oVua+F/zoWXwfIS0LyGc7T5xCfA48S7FUKF71ktZ nzAARp4zXtKZzEWxz0KWFjj9JUVt3cCRfmQn78VGUIKfrBd0fy0p/vQc3NGuZPZAJartGF H5LiynBygLUqaw93OARpKt9xapOB6Yo= Received: from mail-wm1-f72.google.com (mail-wm1-f72.google.com [209.85.128.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-331-wSjGYdepNs2PZOCsfXqwXQ-1; Mon, 24 Aug 2026 16:35:12 -0400 X-MC-Unique: wSjGYdepNs2PZOCsfXqwXQ-1 X-Mimecast-MFC-AGG-ID: wSjGYdepNs2PZOCsfXqwXQ_1787603711 Received: by mail-wm1-f72.google.com with SMTP id 5b1f17b1804b1-499900c9d99so29531785e9.0 for ; Mon, 24 Aug 2026 13:35:11 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787603711; x=1788208511; h=content-type:mime-version:message-id:date:references:in-reply-to :subject:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=xF5sZeAXwZD+/ZPrGJeJEy+40g6EhVdFb+0JKdWdnpk=; b=Z1p+T0h31XRilYbgvAQ6HXtt+YMwd1MozNTbwKHq6sYfw2z6mDvhhv3p2F8efIVTvn PrkgEAV9mWdaEFLl4Xo7qqxWlxVFjmtOg3mRRL/RbL7ii9ewtGpd8cqoSigjzl4qDoPY wOt9E9SuV/vFEvXZ8ihh/6zYCRoDvGFiMHUH0aP674Pjhr1dFJNIQeKzotonYEsCYsEj Q2oe3/2bcw64tsEsxdz0HLQ3Zbae7c+g7gJ0Mt9vSMKB9Rylb6BTi36CeYt6JIqleH50 ciCp3Zx6ZcoP79DJaoqaC368+gl5UNdHah/GEmb/2hrwJ9DMjgl1A1j+62vP2L4TXyoR N0HA== X-Gm-Message-State: AFuF++nLKSoUOShjs3h4qmKVL+1vk42aufoQp5QgrivlCgSakccRudFh KAOVRK4yg6FBfTzAqm7Ml7yAD0YHJiO0H2doHq9kcBYPBDrqzGa0rC102epV4839+CYBVpcvxYV P9Vpk2NrlRK8XCpzHd1CeXqDSQ61IBPNRRWO/nXY22dcHU5PUfqLgLbV1eWIKIUoosqsQRpo1WO KJAnOLQ6NXtXSRXkwRprRNbCuJpMArYI0EgtX3ZUkyFDtYZUY= X-Gm-Gg: AR+sD12HIgwnn6iveHjEQhMFMXFLcfRuuGu6Z4RWCT7jb60qZEO3SchxoPaKwcDLoWO JkTsd6uHFZQaOea9sZk0UXC/LF6RY/fN+61orW+SgpnqWRgLAo6qYXEzcEyQUuZ4itvVvUZvzxP MK5H0BI2E5IBHCIORhbN5to6LyNF2js7QesL4LjuJCnXvrYoAtpUNmzokme5PnEYbTGZcIgikPF 60mlQ5RaJnnhLab/PCVMMAYqVZkakPurd4aBsacuNw0avK4DhwXSC455L/wVBeOjW5/AIbrJ3k7 ByMRlr9NHDpqwGRowfqb4lQ2yROu4spqwTHwAsDCWMDm7dypTOc5TgdAzogTVkFsdZuKZWGxkkZ 0vzV5jdas+acvhhDzoYqXufnVJYM= X-Received: by 2002:a05:600c:6211:b0:496:c9cd:e7ab with SMTP id 5b1f17b1804b1-499d6546193mr21842195e9.5.1787603710955; Mon, 24 Aug 2026 13:35:10 -0700 (PDT) X-Received: by 2002:a05:600c:6211:b0:496:c9cd:e7ab with SMTP id 5b1f17b1804b1-499d6546193mr21841585e9.5.1787603710403; Mon, 24 Aug 2026 13:35:10 -0700 (PDT) Received: from localhost (128.223.159.143.dyn.plus.net. [143.159.223.128]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-499d633506bsm6935195e9.3.2026.08.24.13.35.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 24 Aug 2026 13:35:09 -0700 (PDT) From: Andrew Burgess To: gdb-patches@sourceware.org, binutils@sourceware.org Subject: Re: [PATCH] etc: import changes to texi2pod.pl from gcc In-Reply-To: <87v79olsxh.fsf@redhat.com> References: <91dfc026f843cfb510445198bbc9b63552b04e4a.1784980082.git.aburgess@redhat.com> <87v79olsxh.fsf@redhat.com> Date: Mon, 24 Aug 2026 21:35:09 +0100 Message-ID: <87mrubtfya.fsf@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: vuGMsCTD2vd-uMF9NSU4tA5x1sdgSMOxz9xa52bPycU_1787603711 X-Mimecast-Originator: redhat.com Content-Type: text/plain 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 Andrew Burgess writes: > > commit 1dd632a1865281fbc054e6af55dc1d4a371c4b61 > Author: Andrew Burgess > Date: Fri Jul 24 17:49:19 2026 +0100 > > etc: import changes to texi2pod.pl from gcc > > I was looking at making some cleanup in the GDB documentation and I > ran into a limitation of the texi2pod.pl script, it is not able to > correctly format: '@option{--text}' or '@table @option'. > > Patching our copy of texi2pod.pl is easy enough, but it is probably > better to just sync with gcc's version of the script, which already > has some @option support in place. > > I took the version from gcc commit 3f337c3d7e2 -- that's is reasonably > close to gcc's current HEAD. > > I then checked that the man pages for gcc, gas, binutils, ld, gprof, > and gprofng all regenerated without any changes. Unfortunately that > wasn't the case, so I had to add back some local changes: > > 1. Support for the --no-split option, see binutils-gdb commit > 96a7037cd8573cf065aa6b12baca68696f96d9ca. > > 2. Add support for TARGET as a man page section, see binutils-gdb > commit 6387924ae329fe2a89abb48b9868a340e23a9630. > > 3. Revert gcc commit 386c402747d2bc6bad3e1bc2f9383d4d669576e0 to > allow our lists to be correctly formatted again. > > I suspect item (3) could be better fixed by understanding the original > gcc issue and crafting a smarter solution that both solves gcc's > original issue while also allowing our lists to be formatted > correctly. However, given we've managed without (3) for years, and I > need to make some local fixes anyway, I propose just removing that > small part. At least for now. > > One final note, this import from gcc changes the licence on the > texi2pod.pl script from GPLv2 to GPLv3. As I understand it, GPL > allows for this roll forward, and most of binutils-gdb is under GPLv3, > so I don't see this being a problem. > I've gone ahead and checked this in. If anyone sees any problems then let me know and I'll get it sorted. Thanks, Andrew