From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by sourceware.org (Postfix) with ESMTPS id D0DEC38582A3 for ; Wed, 23 Nov 2022 22:52:11 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org D0DEC38582A3 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=oracle.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=oracle.com Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2ANM2l5d019408; Wed, 23 Nov 2022 22:52:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=message-id : date : subject : to : cc : references : from : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=DfiZDYEKFnk7aJ+RVM25tUftG0Y095f232mveuPUeRM=; b=nFr29QutTvaipXc8KtkbE8FMSbkT6IkUQ0+upeaSfBrFwfi2Lu688QoiTydZOCouJdDZ bx+n57ZHsCq6Fc3f61abxcHv9M37iEN5zezuMAg+ojKVLU/loa/tu5NCLaskYXUc37DN SaTCt4vW9nRKnaiMIPiifxeqeN3N/jDRwVabgvDs6QKkPNSg3GWzbA74byobUzsyXhRz LEpJXW8Cp5FLQjwZKy00MuJPBqsauY3v6uwakRSHMi4Wyi4TVFvA/ixH8/VHrkcouFmb ck9HQwOJHc6Xfqu6gU0UZ/2EMyTXHjOIzHvDU+Eop8EnmZJxghUh18EEz9oeGFyFnNU8 mw== Received: from phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta01.appoci.oracle.com [138.1.114.2]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3m1svggawq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 23 Nov 2022 22:52:10 +0000 Received: from pps.filterd (phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 2ANLf2LM015687; Wed, 23 Nov 2022 22:52:09 GMT Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1nam02lp2041.outbound.protection.outlook.com [104.47.57.41]) by phxpaimrmta01.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3kxnk7e4cf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 23 Nov 2022 22:52:09 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZeB8k3vaLPQEelO//llYcT0QjeoeEBeN4nZO0nVnS6RiW1lPbdNdo0N/J2W19STtnfRVuZ+nnERsedmqvtgLa0wbzRm5js4Ifsf0sHoTfebcSgH2YjO8bLRgM8D9stVpoDLQJbsnRvDBx1sugSHyX81jTiBOUCJeNCX9NRwThhZGPkBo7zhkBPBSEhVCVAq0R71ArJnnBA+63gaSxAnEYzh91+tD5Z9iP2qVbObP83F2GB6g2EueYhBSKR5oAzKcGcWznknBxK5h7MaTaRAzQkZTSIsiEUo4KZbfiDlq4z4laaPWPDWE+Pb2/AeYNYAWSdvNXEhAJqEwqZTugDYH2Q== 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=DfiZDYEKFnk7aJ+RVM25tUftG0Y095f232mveuPUeRM=; b=Ma4CZ8gIbO2asY5StoMZGEC/ZaTKfcclYOWaXgZaLQXCtzgKqvD50AJIy382t4vqJJm6W9KKBNRMsTvTrwkE0yMbU+MIaHAcIV04kztNA21Qhp76uPA4g+fZn++ooyqqtC1AGfXGICFDypE1hofXlLNzuebKG0obmZ3iOYAr4K3Avrhum0Pjf7KiZ57z5iFDKEDTunq2SVzkOmWFNNbUCDNR6X3FOraLkp6yZ57tvt7Seghxlxq/WHXnxSsWTmStat+J+Xppv12jbspaHlnufFv30RJHwmnfSaiMhCLsyM7i4BMflMZ3z4HO8gbXtZwo8Fv9bCcQCTHjhNmlCxyRWg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=DfiZDYEKFnk7aJ+RVM25tUftG0Y095f232mveuPUeRM=; b=DnaiDtaOG0z14A4kgVfz/lWdMgZKUSHXnyTlnXz+vD/9PsJAMMdmk9h3tGjSmAwtBT/Oi1hCEIUL9O5q0s2p08qhz+X25LeRb1Ci/M4ydj33DHsQ+pV1qydDGIH8S+HNYq7e5Joje3wkmmBQoyNFNhButpooKTnJ7cDla/DwLGc= Received: from MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) by SN7PR10MB6667.namprd10.prod.outlook.com (2603:10b6:806:299::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5834.15; Wed, 23 Nov 2022 22:52:01 +0000 Received: from MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::ee70:1952:4416:1bdc]) by MWHPR1001MB2158.namprd10.prod.outlook.com ([fe80::ee70:1952:4416:1bdc%5]) with mapi id 15.20.5834.015; Wed, 23 Nov 2022 22:52:01 +0000 Message-ID: Date: Wed, 23 Nov 2022 14:51:59 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.1 Subject: Re: [PATCH] sframe/doc: remove usage of xrefautomaticsectiontitle Content-Language: en-US To: Jan Beulich Cc: weimin.pan@oracle.com, binutils@sourceware.org References: <20221122221028.2924195-1-indu.bhagat@oracle.com> <5e519a63-def9-6a9c-85ab-fcd987875545@suse.com> From: Indu Bhagat In-Reply-To: <5e519a63-def9-6a9c-85ab-fcd987875545@suse.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ClientProxiedBy: MW4PR02CA0020.namprd02.prod.outlook.com (2603:10b6:303:16d::26) To MWHPR1001MB2158.namprd10.prod.outlook.com (2603:10b6:301:2d::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2158:EE_|SN7PR10MB6667:EE_ X-MS-Office365-Filtering-Correlation-Id: d9285311-aa4d-4a3a-daf2-08dacda55565 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: wtzZerGQQImZfS0t302hJ9KWb8ONFiwtZjmAKcNJZ5xc+3kRotckH0R4BCIATSEyMgujn6aD4JeSJMARLgMrb1MNb5AXJwSdYGtP7UVtaicFVv+Bm+KqTbgBvCuGw78ROze+H3OTtQUAoEN9sinH6ZhnSJXTvqK82kgqXpMYO3uHHgt2PFruA2ZJwDJJj2NRhoybPCjNe69TD5q8tCyGeVGP5X9dKaoCaQdZzIZtwYrJzy5glYXJ+Pivc2Ttg77xSnZopEnUCA4DkS4Y7YbA86JJ8CHIs5sPzyG0NkceDxqWbOdWYVovLgcSTjZjuAq6nQKMtwsnGmDNMyqCd5Y7geuzAYQSzGj9TZlFdpoh8AxkkiYfiutPCPW8VRKZ/XyJT9kDUEpaGjw4/9Rpgz+j++woWkBSfc2mz4KRj6duPZe9BliOsyxX8wEJA0crHXFQF9XO0QJqUW+qbumHTSEVJCaAdC2+IkYopbf4xduEX6hQDEf2ot8xw+tqnGzxlxSkTAwvRTh26++95MyKOwfnuB4PGdkTntm2WbVfz9FQKyPS4iL8Y9+JGbj8DyWEo5kOnWUQ2mBxouflDtnDsKjqG+oSyaJk9Nx4GV4S0bFVKEM7Lue4YoqGKdDUxRGu7NgQsogZ5/F13t3AoFe9v1senu2cM804lvM4L1uri4g3tWQsFRMELpgkzCgZjEWUL3mMiUHPfjNjZUfQtH3GKkS/yzkZbIwJ2K2gY+io7VyIVqtK25g1TdUSp/nzYD8+Zt5D X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:MWHPR1001MB2158.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(136003)(366004)(346002)(396003)(39860400002)(376002)(451199015)(6506007)(2616005)(186003)(53546011)(38100700002)(6512007)(44832011)(2906002)(5660300002)(966005)(41300700001)(66946007)(4326008)(8936002)(6916009)(316002)(66556008)(478600001)(8676002)(66476007)(6486002)(36756003)(86362001)(31696002)(31686004)(45980500001)(43740500002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?SlduSURDVit0WkVlWlB3NE5kckcwVGxxUkprb1ZWRnJZbUZObWZEc2FSWk83?= =?utf-8?B?Q3lmRnY5REtBTGdFS0FLaVVnOHpFNU03RG95anE0Rk53QjkvcnEwZFZkV0xO?= =?utf-8?B?ekZuNUdqYWxobmlvSXpveXY0SXRDV2FhNWVDY1VjbkU4M1BIVThPem5SKzll?= =?utf-8?B?Q1NBMmxDVGZwNHo2d0R2aEZGRlA2TFV6bElxcC9vU2VqSlR1M05ZWmhReFFn?= =?utf-8?B?MitoWVJNampjbVF5OTJQK0lLc3dyQXpRWU5ZYmM4SGxXc2pzK3BPRlFIQmUx?= =?utf-8?B?WkZRZnJ2d2VHNGhZcG5BamE1SE1laVNrUzBKMWMweU5aSWhiZTRUMWRML3gz?= =?utf-8?B?T3lUS0o5b2VreWtQczJ2djdENDdXSDNWc1NEUmlPaGhUcnN3MzJSTDlNZmVC?= =?utf-8?B?NlVia0pBK1VpTlFWZlpNZ3pNMUNEN2tsZHorb2U1STZtL280SXg4Y21nMUZB?= =?utf-8?B?UmdaRUZCcUcrWitSN2VvUitrWFkvSnJlaStodVZrYlRiMjNLb2lLYStwNkdL?= =?utf-8?B?MnRiMDd1ZkRCdlA3REt0NWZmQTNUREdiVytWckhNcjkzVVU4L3BTa2s3YXVa?= =?utf-8?B?SFBOQlhzcDlnR1Izbi9Bdnl5QlhQV3VtUnEzSnArVVdERlNGL0FGYlFKcHlM?= =?utf-8?B?Z0pIYXVGb2hJUGQvcVpablJMKzVkQ0FyL0xpd2xXWGd0VjlRSFVBY1dQRkYz?= =?utf-8?B?cFZLejZVTXpINTRORnRieFBVY3YyUkZLczRRTDJmWHN5TmE5bnRRUU5nZUJW?= =?utf-8?B?MWp0VGJFQ2VUcC9RQkEzVmIyUVptakl5bjR1VFdCd1dodnRldHF0amFyWlZO?= =?utf-8?B?cEJJZ3RZL2g1MStQRUNkeXBTZzNaQjV1dGljbVQ5V3RnWVNBR0swRDVYbitD?= =?utf-8?B?bWxMR1R3RThHU2FndHNoKzBUMU9JODM4RzJiUGlES1RrdFJRRGNXQmt2ZitO?= =?utf-8?B?YXhxRWltcTNFV2hlR1pzK0gvOVFDR0o1QXN2dFJoMTIvQk5LVXpWSHZLd2Fa?= =?utf-8?B?OEJEOE1naEZoL1ptUVA5K3didGVuendKY3M0TDNTZkExdDFxQmxKNVYvRlFj?= =?utf-8?B?S3dPaDNrRmsvSnloYzRqNjNETEV3YzVoOE80SkFiNXgzTE9PWUsrSFYzdVdB?= =?utf-8?B?S3FzYldqTkQ2TDBnMUdPeUVTdXd1cTZhSnJFeDFsQzFhcG9heE1ucEJVZXhP?= =?utf-8?B?R2I3Z0pHVENxbUlESFhTR094ZmEyM1dFd3VROFpyY3FiZHliNXByaU5lV1dQ?= =?utf-8?B?RUNCWG0vQ0VEZTdNd2JSYlFVQ1Y1QnM0YWozRXZxVEdJTTc0dmtvblN6b0hw?= =?utf-8?B?aUhGWEVlUisxK05sYUhEV1pwYkZya1grdVBCUTlVUUFQeHI2NG9xQncvK1M2?= =?utf-8?B?KzlYTERIS0t0WUwxeUVGdHp2a1FwbmJGQ0lnL0xFM2d3a3hlZzNPTFZjK29x?= =?utf-8?B?czgyMEc5eHV6NFUxYkg5SEF0K241Vm5GMVkwS1phZW1kUzgyUDFMenk5NGdO?= =?utf-8?B?Q3hZRDkwZkE4elZwSCtFYXNNOFFMM2trQXdBbWRDaWEwT21HK0NFTVJvZEMy?= =?utf-8?B?TFAyNTNra0dFNmdOMHFRbm9nM3diNEl0SUJuMGs2WkVoZ3F3dkFGQnUzRHFT?= =?utf-8?B?bDRwajRWb1YrMGhMQlh3UGdxVkh2Z0tsMmc0MmVFaFVIcWdmZ1VUSS9SbUlx?= =?utf-8?B?czBwRy9yakMwaEs1bG5RUStOVmgwNVR1UzJPMjdiNTY2ZDljQkY0UlZjV3ky?= =?utf-8?B?S3YrTldaRkp6bzVaV29mOXpoV0ttMzAwRDU4bEc4M2dLcnBwbHFrODh4SUVx?= =?utf-8?B?ZzVuOFE5SmNqMjhYai9SYU9yTTI0QVBXbDJFcmxsUDcxUCsyU3VadjZ1NEdx?= =?utf-8?B?TDZ1Y2RKV0g4a2Q5MnpCK1BVWjgvNkJmZ2VtMS9Ea1luemRYcEVHRU5lUG5h?= =?utf-8?B?ZE5PMUVFNXdJZ2hFUU9kQytMbEhaSmxndzl3bGlSYzdlWi9nVEpuU3EyKzJF?= =?utf-8?B?aFJRTytlTjVXd0JpNXh4K1hjUTBpQXdIV0Z4NTZyZ1J3K2t0SVdGZ29CR2l0?= =?utf-8?B?OTRoQnFEZS94MmtyMXcrMy85c3hiZklublgxWXFyeVdoWU9obGd3a3YxRUpu?= =?utf-8?B?UzdEdWdHK1Y3ZmM3VXBsSEJwNmdJM1diZ3dqNVBneGdNWGpQWk12QmxicStP?= =?utf-8?Q?lgJ3Nx8EJJGf/BeZmpcCvVI=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: WM4ni0HZpzJ84GyYYFTw78agEqLZgZd+V0UmsSAIVafNgMxgDM+uD21AEJgtxYAdJ5SOgh3PguVo+fO9suGI4MXSfbDdWy1hyj2ylr386u19kh5Xk85lbgDHBaaSlFqQAOiycL+9zZAAN6N3URa6gTq+6AAaT4HeIX2KfoNVNg/dSOi6hi1QxGa98GpIxDcgkPEsZ/of9SXi4Ale4SZGBQUd0ycbC0z4KY5edOUTW9m2RUWzaiNT6ACyTt5nb3z2Zyz4c0MaSytEyZRU0TyvyWwirCV0v0cVBn1q6XAT6NAd6MlYih5Kpgmz1tnJeEA6bH5NehnN6puNBU+G+RqTBmBHbEah+iV/BLLGrV9VFzhZURwsV3+q2PDKVB35ndjCENruFUQ4fjzFrd7ntByoRt9rnGJnjl4NtUtlcK7/yScpY0fiySTjxs1BgTF9xc+JC/17WTfl7Bv3zyVmkoAIsX+y9nAajaES8y6HVMm2Czs6+VIoNSTB1WrGderDEuls0G8eNpYqFEIhRwA1uDY0BgCSc/8EMr3ayZrI1wi1vFDtKGpSI+HLSQnoUVxQdxlcx00nSJ/i45zxi4mXLMsIkKgFqc0TGgWOCIg0rwxc8CYSaLn64LXmmywXSUaj9FQbSKxfmNX7flsG9s9L5CHXmd4737CCD/gVFWww7QBMuVTgRWcaMEXxzBL1gTlsZt7UOVoUYic243GCAF11kJLJsDjq7lqkqjxVcgQmcPoRxiET0vFIQFEq6ipo3BHRJYcPQkEh4VYYEm5gO+BhWrvJZxWGUGubrR9K8pAqEHmniYs= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: d9285311-aa4d-4a3a-daf2-08dacda55565 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2158.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Nov 2022 22:52:01.3632 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: AuNz9yBkwIWFxHlXHTmtT7uJDfsM0dTbApiMY/ktqUB8vtEpWQNbjQO5HjyNOiSLrfW6+8pWjk9abl3GIDoj2Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR10MB6667 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.895,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-11-23_13,2022-11-23_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 mlxscore=0 suspectscore=0 malwarescore=0 spamscore=0 bulkscore=0 mlxlogscore=999 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2211230169 X-Proofpoint-GUID: OgDVgHSz131JtfDUIX7Td0BY1f9zTB0K X-Proofpoint-ORIG-GUID: OgDVgHSz131JtfDUIX7Td0BY1f9zTB0K X-Spam-Status: No, score=-7.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_NONE,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 11/23/22 01:07, Jan Beulich wrote: > On 22.11.2022 23:10, Indu Bhagat wrote: >> xrefautomaticsectiontitle appears to be available from texinfo 5.0 or >> greater. As such, it is not worthwhile to add requirement for a minimum >> necessary makeinfo version. So remove the usage of it. > > Thanks for making the adjustment, but is simply deleting the construct > the right thing to do? If this didn't serve any purpose, why was it > there? The construct was being used in a sort of useless way; and I understand more of this only now. xrefautomaticsectiontitle was guarded with @ifnottex, but IIUC, "@xrefautomaticsectiontitle on" has _no_effect_ on info documents (I see the generated .info has node names with makeinfo 6.8 and also https://lists.gnu.org/archive/html/help-texinfo/2020-01/msg00033.html). It seems (at least the newer) makeinfo uses node names for info document always (..and section names for HTML always). > Yet if it did, is the result now less useful / usable? > Usability is not affected. As for usefulness, for sframe-spec.texi specifically, I think the node names are also equally informative, and IMO, there is little loss of quality of the manuals with using node names instead of section names at this time. For example, there are usages like: @node SFrame Frame Row Entries @section SFrame FRE and, @node SFrame Function Descriptor Entries @section SFrame FDE which will need to remain for @menu items. In any case, the needs of sframe-spec.texi are simple at this time: I have a patch that aligns the few other (unnecessary and confusing) cases of node-name != section-name in sframe-spec.texi, perhaps I should include it in a V2... Thanks Indu