From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-db3eur04on2053.outbound.protection.outlook.com [40.107.6.53]) by sourceware.org (Postfix) with ESMTPS id 4E0203857C71 for ; Fri, 3 Mar 2023 08:20:20 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 4E0203857C71 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NKs2FBqAeYuNrZpktV1aKYM0Ta+aDOmt6w0td5GpAbYcB/haEXFemIXN+Kw2b5iGMi3dmvkdij+/Wl6vxEuoEwqfEYB9towbx1lQMVIPiYi9o1xaG9g0JOtjRbMN9/zTOGLAP9dK7xDZdr674FrNQuFMH7XmDeSWtE1ObymESnM7vv8EhvPnWwdduF790y9pmf5T8gvfHDIW2uX4KVi7mINiXFcGbKmK8tBSc2Y2LjMwoOIiACauHeqOjmsXtzTZXj70LLGzmO66gJjV5hrScpdPDjdwwhJ81KLzIw4qbKFXCYutOevfKE374BbLl4snlWYQDQ0W25b+Z+kIIn1V2g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=1+T0WgxigJs0AAW2NhIzKotlcEIhpZwwU1vRqhDJbEU=; b=DI71VULvDktTLxcX33i6gV0Y9oOEE2oBZgKAzM9LXx14dIWB8rchkF9c4Dl/zSYd+JhVCqehrTi6gHzr4bQshmR7qB7YhRHYXzU4uR8Xh5me3OhKNE/cnP3QMNHmezANjPehtsDHl1y3i24bZRp2ALWf9Yk7w/yqsU7ju4AzAtSM0pTqfU0A7uTbSj10Qi8yNlUDEum1OIddwZ+/KEH2SFIMzfH+un4TGiMIJT2nwnfShT/6+g7Af7SSj/lqnt5ZcCDXETvETtPXlMHz3z+opAjvXcGxQbBYW8137oi05+RCp19jwDLtRbP1KX9egvgisiqvC8hij0tVEZYXVnrPbg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=suse.com; dmarc=pass action=none header.from=suse.com; dkim=pass header.d=suse.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1+T0WgxigJs0AAW2NhIzKotlcEIhpZwwU1vRqhDJbEU=; b=hdOqNSAn3Kl9+Qwbq6tuy2U4TkneZrL2lxDDpY3RU/0rz6pExPirjLXnLsjG6UQrUnwNeV5y1tRVZaslZme/YsNsYesvtXlzDTqehWOgaxnay4VPpO7t6TicfDSeK1X5qmE00fw6GCWur6qrwzYzuF26O9AWS1ojd400sHlYr/nAFWvBUSj0BILFHg7O3s3hqE8W8AcWi7Igeudbt6CzQ80s8v1PfXxRo60cj/MnboPY9FVkDuHCr5XFazzHt2unarpVfxSCoMwN/Vfu5mOCVAK5dg+xg7omm3AkdsX7OaPQ0At6DHAFaXODhCOsP3dIrlrJAyjGMm7ev3kooUU9jw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=suse.com; Received: from VE1PR04MB6560.eurprd04.prod.outlook.com (2603:10a6:803:122::25) by DU0PR04MB9417.eurprd04.prod.outlook.com (2603:10a6:10:358::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6156.22; Fri, 3 Mar 2023 08:20:16 +0000 Received: from VE1PR04MB6560.eurprd04.prod.outlook.com ([fe80::154e:166d:ec25:531b]) by VE1PR04MB6560.eurprd04.prod.outlook.com ([fe80::154e:166d:ec25:531b%7]) with mapi id 15.20.6156.019; Fri, 3 Mar 2023 08:20:16 +0000 Message-ID: <8392b8ac-2447-2721-706b-aae4c3021404@suse.com> Date: Fri, 3 Mar 2023 09:20:15 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.8.0 Subject: Re: [PATCH 2/8] Simplify @node use in BFD documentation Content-Language: en-US To: Tom Tromey References: <20230208071725.3668898-1-tom@tromey.com> <20230208071725.3668898-3-tom@tromey.com> Cc: binutils@sourceware.org From: Jan Beulich In-Reply-To: <20230208071725.3668898-3-tom@tromey.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-ClientProxiedBy: FR2P281CA0079.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:9a::19) To VE1PR04MB6560.eurprd04.prod.outlook.com (2603:10a6:803:122::25) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: VE1PR04MB6560:EE_|DU0PR04MB9417:EE_ X-MS-Office365-Filtering-Correlation-Id: 9f60d74f-097d-44c5-7d9f-08db1bc01eb7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 8iaRGuvBuqEbnn7waKwNZ9byiLFgvNfwfti9RqVFuPidn/Wrh3x988VoBa21Syp0omZIOUTwUlIK/cnjMmCx9ZlL3kR+Y0C+pgOdLM0Tz+sa1uQYXVPWRmgfFLb4E85gqB71Ep450jRUX81ZFCa34dBhXnBRBJZSN/SMAEeFKK6TzNWKWnfoWi9uE0kmz2S9f7cL9is8grlnPx9hHv4aSB7HFLF/aTWT9HehZ6/CfZTX5t/V4lNhMG9ezvb/mEaCCtTjcKGqWfgdy+tuonyqxS3nreuaNDaH3tpadc8RoeB/k1+w58129tYsCstgNABXVgwWw7j2JSY6fii5lWmMFgAOy74HjxPGSxT8UenQrRpYB31mQRgas+WcIcY6gD9Q6sjk8HWH1REykfqAE8NNen9K7VDeD3LZxgPdVXoOFMvH+TKJjsWlRkCSvOrWhFH4pItV1iELFfIeiGRUQly8rATp4SauSZ3xJKHaXi8i5V1z5cGcKyrG0BK4QmE63XYf2Owytx7QytWaaAWAH1HmofiSw+zRLb6zCYs02YAYRScsncXsDygBroF4zAddpZ82Gm8cqIQvRTKu+ngc7M58dnCVQC+hR2QfXmce7aaHDzCtQPYZ5Y11CUwbvjN5k3BNmcqlB/5pcRUkjeskorE0Sc/yLJC8WoSDilTAMBkJvAaW0cBcgfBb/pxNyn6XaHbVI4USgfXepaYVbE/2Wt+F8MM9oSqaII95QuughLwkQ3Y= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:VE1PR04MB6560.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230025)(396003)(136003)(39860400002)(366004)(376002)(346002)(451199018)(6512007)(6506007)(26005)(186003)(53546011)(316002)(478600001)(36756003)(5660300002)(6486002)(2906002)(31696002)(86362001)(8936002)(8676002)(83380400001)(6916009)(4326008)(31686004)(66556008)(66476007)(66946007)(41300700001)(38100700002)(2616005)(45980500001)(43740500002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?KzNUS2RSYjRzRmhmeDREOTI3cFZVbUg4TFpRQURnTUcwSGVqYloxZ2ZvWStt?= =?utf-8?B?MmlOZGhrVjk0RXpDQWxzSGJwbStmbzlSTWtXNjZ6NUlKc1BYSmZFMlphckxU?= =?utf-8?B?bFllTUoxS2FQTWFCN0FSalcvTEtKQlN3VDdaRnhkQkVVcUpPUWRiYjNIQUtm?= =?utf-8?B?OEdWTTVQMm16VnpuRitiSzdJaWtaMkJ2cUQxMkM4VDlweXBoZ2tjWHFldDBD?= =?utf-8?B?bFE1dnN1MDNia0txdTJXWUFKZEJrTkI1eFJMYWFUZzZRQk9Zb0RnSzdHQi9j?= =?utf-8?B?NkcrYVdXNEVBYUVSWmlldWx5VmJERDdmYWlGaTRudzV3SmJseVhEL1NmcWRY?= =?utf-8?B?SEkwQWJ5REQxbHR1SWVqQWR0QlB1dDh2QlZ2bHNFeitkZ1FLampPK0F0eGNN?= =?utf-8?B?ai9wQUtvK3VxWjlPSk1RK2NtTHNYRkVPRHJhRjA2a3N1ZVdUY3E5RlRPdGJY?= =?utf-8?B?ZGZ0anFkb2lJbmxxZ2tkQmFyN2VoWDJtcEhOUnhDY1AyWklkNjRPeSt2eDMy?= =?utf-8?B?L3VCMlgxVkdGbDdjd3hWeXBLN2NZc05KQ0NmN3NrRlVGenpzVEVLRThUL0dW?= =?utf-8?B?TGJrY09QSStOaEhRK1pDV1RsbStMWkFEQVhnNnpodWxzNWYybjNPUC80NWxj?= =?utf-8?B?SHVUNmw1YjFzZ3VVbUhwQkxxZFhIM1ZNdWRuTEFOdlJUa29ZY0t0dlpOcnFh?= =?utf-8?B?RUpkbWk0NXB0MkE4UjNHdnRKWmVtamVVRUtYTHBtMWRMWnkvc2VzRVV6U3o4?= =?utf-8?B?bHdWRGJML0twTWgvQ0lTdFlLVkc5YmZyWjM5TldMNmQzNlo0WUZORHZLRExm?= =?utf-8?B?b0ZWZDN5K2JxOVJCZlBmeEdGOThUd01XTzFIdS9nR0J3OWptcUxYb1BXRmNp?= =?utf-8?B?UGFtSDN5dUZ2RTkrTyttNm8wc3JBeEFQeFlQWWxLUjlsM1RsVzlnU1ltWFoy?= =?utf-8?B?UHBub1MwaGNnblg5c2NxWGEvK2ZteG40Q3VOd0syUUFUS0k3bjdwUXo5RHdw?= =?utf-8?B?WG5RaDRleVg4cmlWSklzUGZGeGh1RlhyaTByQTMzMkZNYnIrVWZGNGVNNkxF?= =?utf-8?B?N3dQeWtuZmQyUXNiNkk2Z3B0QVYvbHNwdXBCU0NJS1Njb2tDNlltSGlNMzZP?= =?utf-8?B?amtEaTFZSnNLc1N5TCtINk1MemhqS1RnbFFwRjJENkh3d0NRaUpSZ0NGdU01?= =?utf-8?B?eTNrL2RLRmtlSFM1NFFlZE9wUVh2OU9HY3hqQ2ovN0FWYW44cElrQkNKTXJC?= =?utf-8?B?Z1RXalFMbWM0eWZaRnJOOWFJSGhBNXhLcVJ5NkJEc0pjTEZuOVc3Q25lMGxi?= =?utf-8?B?UjFmQzJ2VFVsRCtvUlpJWjhZazk1U1RHWkFyOFMzeTNKZlRUenl4dGN1MTVS?= =?utf-8?B?Qm1aazZla2pSZUNianZYeTNyYVJkUjIxRG9ONUNrT1BSQXdKb2R0YVpndE55?= =?utf-8?B?d0d5WG55dGhubytQa3Z6RUwrR0s4ZWZURHpRb0szd2V2Y211R09jQllSMm1s?= =?utf-8?B?Ym1lR1pJSWNIUzVhK2F0Z2x5Zjh0UXJ6NDB2cW80bUlVZFpDTEVFb045eG9u?= =?utf-8?B?dnd1Y21TRXVmckp4akRtN0xON0l2cjVNcTBadHp0aVJnNVpkWWVqWUJsYlBV?= =?utf-8?B?MGZaTm42Tk1QekRUbHZRUHNISW4zUURKRlNOSkpvUXd6WGJrbWhmaUVxaW9K?= =?utf-8?B?YkpTTzRLS1JuN3RmUnBZZEZ5TFRUN2w5NnlsUy92dUNTQWhjQWZZd3pubnBa?= =?utf-8?B?SGVkeE1pM1doZjd2VGtuallCNDlLREQzK3VFOW1aamtBZDhwY200Nlphdi9V?= =?utf-8?B?WHZGL0d6Sy8zM3NLMkVtS29EWUtuUmxnbEdjR2hodlR6WlAybFNsa0Z5a1lp?= =?utf-8?B?MHZ0U29wdDArT2NyK0xOYVhNTnJxaWhjMmZSMXpKMitRMklyTEpZQ3VuUm1S?= =?utf-8?B?Wmh4eVAzYlcxMjN1OEJUQWRaeFJqN2VISUU1MUtSZk9XY2xSRjlJMVJzOE91?= =?utf-8?B?dEhKWlQreUN2WmFweEdwcTI3azR1RkEvL0UwaTVyNXFYZVgwa1hBSi82RzdW?= =?utf-8?B?Q1BMNGNrRHo4czJxc3NyTEl0eTJRT2ZvVFFWTUdaMktEbURrOGUzYlJ1R1Rn?= =?utf-8?Q?Wx7Vwirg4f2q3ODzBRPJBj+EI?= X-OriginatorOrg: suse.com X-MS-Exchange-CrossTenant-Network-Message-Id: 9f60d74f-097d-44c5-7d9f-08db1bc01eb7 X-MS-Exchange-CrossTenant-AuthSource: VE1PR04MB6560.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Mar 2023 08:20:16.7944 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: f7a17af6-1c5c-4a36-aa8b-f5be247aa4ba X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: eh+Cfx7PtDrTfrLYSaQEeOE5y7IOxd3elXsnnI5iPVNU+gq0v+dxTyC8joJ6/hw2jLihrRUiUxgSy0ILnlFAFA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR04MB9417 X-Spam-Status: No, score=-3028.4 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On 08.02.2023 08:17, Tom Tromey wrote: > The BFD docs currently specify all the parameters to @node. However, > this results in bad navigation in certain nodes -- the "space" command > in info doesn't know how to find the next node. > > I think this style of @node is a leftover from ancient times. > Makeinfo can figure out the node structure on its own now, so simplify > everything to a single-argument @node. > > 2023-02-07 Tom Tromey > > * doc/webassembly.texi (File layout): Remove second argument from > @node. > * doc/bfd.texi: Use single-argument @node everywhere. > --- > bfd/ChangeLog | 6 +++++ > bfd/doc/bfd.texi | 56 ++++++++++++++++++++-------------------- > bfd/doc/webassembly.texi | 2 +- > 3 files changed, 35 insertions(+), 29 deletions(-) Does this change need to be accompanied by an update to configure, to build BFD doc only with new enough makeinfo? This is what I get with 4.12 (admittedly old, but apparently deemed acceptable right now): .../bfd/doc/bfd.texi:245: Node `Sections' requires a sectioning command (e.g., @unnumberedsubsec). .../bfd/doc/bfd.texi:248: Node `Symbols' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:251: Node `Archives' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:254: Node `Formats' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:257: Node `Relocations' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:260: Node `Core Files' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:263: Node `Targets' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:266: Node `Architectures' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:269: Node `Opening and Closing' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:272: Node `Internal' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:275: Node `File Caching' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:278: Node `Linker Functions' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:281: Node `Hash Tables' requires a sectioning command (e.g., @top). .../bfd/doc/bfd.texi:300: Node `aout' requires a sectioning command (e.g., @unnumberedsubsec). .../bfd/doc/bfd.texi:303: Node `coff' requires a sectioning command (e.g., @unnumberedsubsec). .../bfd/doc/bfd.texi:306: Node `elf' requires a sectioning command (e.g., @unnumberedsubsec). .../bfd/doc/bfd.texi:311: Node `mmo' requires a sectioning command (e.g., @unnumberedsubsec). .../bfd/doc/bfd.texi:314: Node `GNU Free Documentation License' requires a sectioning command (e.g., @unnumberedsubsubsec). .../bfd/doc/bfd.texi:317: `BFD Index' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:314: `GNU Free Documentation License' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:311: `mmo' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:306: `elf' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:303: `coff' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:300: `aout' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:296: Next field of node `What to Put Where' not pointed to (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:300: This node (aout) has the bad Prev. .../bfd/doc/bfd.texi:284: `BFD back ends' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:281: `Hash Tables' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:278: `Linker Functions' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:275: `File Caching' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:272: `Internal' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:269: `Opening and Closing' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:266: `Architectures' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:263: `Targets' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:260: `Core Files' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:257: `Relocations' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:254: `Formats' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:251: `Archives' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:248: `Symbols' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:245: `Sections' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:222: Next field of node `Memory Usage' not pointed to (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:245: This node (Sections) has the bad Prev. .../bfd/doc/bfd.texi:195: `BFD front end' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:91: `Overview' has no Up field (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:78: Next field of node `Top' not pointed to (perhaps incorrect sectioning?). .../bfd/doc/bfd.texi:91: This node (Overview) has the bad Prev. I have no insight yet what else in the series may cause further issues. Jan