From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from outbound-ss-820.bluehost.com (outbound-ss-820.bluehost.com [69.89.24.241]) by sourceware.org (Postfix) with ESMTPS id B68543858291 for ; Fri, 17 Feb 2023 19:29:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org B68543858291 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=tromey.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=tromey.com Received: from cmgw12.mail.unifiedlayer.com (unknown [10.0.90.127]) by progateway2.mail.pro1.eigbox.com (Postfix) with ESMTP id 25596100478CC for ; Fri, 17 Feb 2023 19:29:16 +0000 (UTC) Received: from box5379.bluehost.com ([162.241.216.53]) by cmsmtp with ESMTP id T6Q0pq94qFh3zT6Q0pFcQj; Fri, 17 Feb 2023 19:29:16 +0000 X-Authority-Reason: nr=8 X-Authority-Analysis: v=2.4 cv=QpabYX+d c=1 sm=1 tr=0 ts=63efd58c a=ApxJNpeYhEAb1aAlGBBbmA==:117 a=ApxJNpeYhEAb1aAlGBBbmA==:17 a=dLZJa+xiwSxG16/P+YVxDGlgEgI=:19 a=m04uMKEZRckA:10:nop_rcvd_month_year a=Qbun_eYptAEA:10:endurance_base64_authed_username_1 a=pPovT6DF6pheyC7fxKoA:9 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tromey.com; s=default; h=Content-Transfer-Encoding:MIME-Version:Message-Id:Date:Subject: To:From:Sender:Reply-To:Cc:Content-Type:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=bwPhumVOwDrRxNJwckoivcv4VoEMOjvA0Ub5pGTn7eg=; b=cPQOEfW/QMjATvl4cv5lnurtQu Tme8F7P1OQYTzaNZrb7P0DO8t1Q+zvUz8o2JaWsR+noV+gdpeMp8hNO60fggKRwH1gf9EnbsWhyXi sfhPOKwkHOxcEzn1qSDsYmWv6; Received: from 75-166-130-93.hlrn.qwest.net ([75.166.130.93]:37066 helo=localhost.localdomain) by box5379.bluehost.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95) (envelope-from ) id 1pT6Pz-002oM4-RX for binutils@sourceware.org; Fri, 17 Feb 2023 12:29:15 -0700 From: Tom Tromey To: binutils@sourceware.org Subject: [PATCH 0/4] More fixes to chew documentation Date: Fri, 17 Feb 2023 12:29:01 -0700 Message-Id: <20230217192905.3160819-1-tom@tromey.com> X-Mailer: git-send-email 2.39.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - box5379.bluehost.com X-AntiAbuse: Original Domain - sourceware.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - tromey.com X-BWhitelist: no X-Source-IP: 75.166.130.93 X-Source-L: No X-Exim-ID: 1pT6Pz-002oM4-RX X-Source: X-Source-Args: X-Source-Dir: X-Source-Sender: 75-166-130-93.hlrn.qwest.net (localhost.localdomain) [75.166.130.93]:37066 X-Source-Auth: tom+tromey.com X-Email-Count: 1 X-Source-Cap: ZWx5bnJvYmk7ZWx5bnJvYmk7Ym94NTM3OS5ibHVlaG9zdC5jb20= X-Local-Domain: yes X-Spam-Status: No, score=-3021.0 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,JMQ_SPF_NEUTRAL,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: I re-read the chew-generated BFD info pages, and found a few more issues. This series fixes the simpler ones. For patch #3, I looked at adding a GLOBAL directive to chew, to make it possible to document bfd_use_reserved_id using @deftypevar. However, because chew doesn't really implement conditionals, this turns out to be surprisingly tricky. It would be simpler to just turn this global into a setter function instead -- there's just one spot in ld that sets it. Alternatively, maybe adding conditionals to chew is the way to go, as that would also let us improve the documentation for macros. Tom