From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 2cCkCBlOjGqWVTwAWB0awg (envelope-from ) for ; Mon, 24 Aug 2026 09:58:49 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 1A5301E0A3; Mon, 24 Aug 2026 09:58:49 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-5.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=unavailable autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [38.145.34.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 3F7F11E033 for ; Mon, 24 Aug 2026 09:58:48 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C7DAC4BA7993 for ; Mon, 24 Aug 2026 13:58:47 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C7DAC4BA7993 Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW Received: from OSPPR02CU001.outbound.protection.outlook.com (mail-norwayeastazon11013007.outbound.protection.outlook.com [40.107.159.7]) by sourceware.org (Postfix) with ESMTPS id 1576A4BA2E0C for ; Mon, 24 Aug 2026 13:58:20 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 1576A4BA2E0C Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=arm.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 1576A4BA2E0C Authentication-Results: sourceware.org; arc=pass smtp.remote-ip=40.107.159.7 ARC-Seal: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1787579900; cv=pass; b=bgr9YFKytu7RrK47ONQzSmTla8VxjSOIpoYd91Zy+uu1uVlZxSYN0B56dAUJPyGHrYga3amVP4bjdI+4dkHEh1m3m7ZRijvqpZ/PiOCL4NSeRrUoT8uSloCksx1gzYSEPCg7v6NQlCnudMywroJaehxgPXlbaXBhdvk5ODzMcmU= ARC-Message-Signature: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1787579900; c=relaxed/simple; bh=JJrv7L2K7hXeaqzHlasehrTTQgHXXvkEmBf7FTd68RQ=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=sDA11x07n0quZjM4xAsizDbvqrvptSO5WlDGSN8MIXEpUpX5hpo4WlY69SGYaZWLS3V3k5Vy73mQcwZzJ+UxV9FbENfWPIZxkju3jPl+08qI1Os6j3U8DU0UgTPqnBQSSdLsd/KlRrtGb8GmCPk2ze8LqAR4BWXSyhjN5lyZfPI= ARC-Authentication-Results: i=3; sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.a=rsa-sha256 header.s=selector1 header.b=CEacsuOW DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1576A4BA2E0C ARC-Seal: i=2; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=pass; b=E57hmGvtFx0zfr4WQVxhhQxKnnqTFNTmZNWNHAAJaIQCnbtG8hy5tmmciz6PIg8aM4eWMCsOjk0Jgve4WjlTMShp6khYWkk5M5dztdFghL56R+EpNsMTQ1vZy3qUX1XUJ0YzFGPuNGu+KHdM9i3So38etdEQaEtfKwU/Gg6+MNJexYQ4R9Mw9FxQvFdkIXzvES6N2St9LkLvOLXOo92ZziVBmR4Qnn52Lm8HG9AQodMS5qDVwIh9dqQa900PRN2pspmaLFf8rK8Uyx7d8Ql9rFa0z7vJbMYvSA6WYosGt0lJ0WEcwynPBt7MI2WcfRoURPlPFMQlZLtz41gHQ4z39A== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=utiSV9NY9N1U9EfHhQa7X6vWZDTYhgt2OEmwNAM7eXA=; b=vRMnRVuJpCLrg0+r1F4cBjey4qb554HW/vRXwQUq9FDQOppTis5W6Gpy/LmLxDTb45kzmnl7fFZz8huNvBusmXeAnNX7PeKMQaBHRxoglMiQMJW6GTJyOd1akvZLAg3Y5i9jc2EkJdHx5VkwHsbRZ4XFrqbnTBYIU1NoiCdTokevTaQL37bMR2NR+qijH1+k8yvJ5+YTuLlb49ERgY5lwKO0+nuryMWNPn83uGZycR0T8JzS3NxrNxSijOQNve0Ju48xOtrcmW9V/qApTqL3Us/F9RsyhCR87yjpHlzKsqlXduhnPYERugXpHBzMIrGzlcg7ceIon0RktSSNHgGhuw== ARC-Authentication-Results: i=2; mx.microsoft.com 1; spf=pass (sender ip is 4.158.2.129) smtp.rcpttodomain=sourceware.org smtp.mailfrom=arm.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=arm.com; dkim=pass (signature was verified) header.d=arm.com; arc=pass (0 oda=1 ltdi=1 spf=[1,1,smtp.mailfrom=arm.com] dmarc=[1,1,header.from=arm.com]) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=arm.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=utiSV9NY9N1U9EfHhQa7X6vWZDTYhgt2OEmwNAM7eXA=; b=CEacsuOWSY/cFUeaiD5WpRqLw3fANxemj3QhofHkdeqPENO6mFwsuV4SHQTmuivaZFgw+e6pj9Mw15jk6nWqLKFguQ3/4p9TyawfKI4muFXA67PKAwq6cuqoKfoFt/Xl0Qlk8pjW/qpwkqVxFZUdOkGMAqRSNkNPFjK03q0Xx7Y= Received: from AS9PR05CA0161.eurprd05.prod.outlook.com (2603:10a6:20b:496::9) by PAVPR08MB9795.eurprd08.prod.outlook.com (2603:10a6:102:31f::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.339.12; Mon, 24 Aug 2026 13:58:12 +0000 Received: from AMS0EPF000001AC.eurprd05.prod.outlook.com (2603:10a6:20b:496:cafe::a8) by AS9PR05CA0161.outlook.office365.com (2603:10a6:20b:496::9) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.21.339.12 via Frontend Transport; Mon, 24 Aug 2026 13:58:12 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 4.158.2.129) smtp.mailfrom=arm.com; dkim=pass (signature was verified) header.d=arm.com;dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 4.158.2.129 as permitted sender) receiver=protection.outlook.com; client-ip=4.158.2.129; helo=outbound-uk1.az.dlp.m.darktrace.com; pr=C Received: from outbound-uk1.az.dlp.m.darktrace.com (4.158.2.129) by AMS0EPF000001AC.mail.protection.outlook.com (10.167.16.152) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.21.360.3 via Frontend Transport; Mon, 24 Aug 2026 13:58:12 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=R4r7Q6bxOhIepIe7l/sx2MLFsWzmA7eQFktUtcAFrce4J3nmFKOB0MMFsuUD5uh1UvzMFj7zOAdahCpEGyUZ9mICVC5Wo5omUUNpZ+sybQG/dicJHdYGsARqLcg6jtfqrDsUjqQat4G/FCcRAhkqA91bvf5ZzUzr3hZ/ZqINx6xE0gi0p4QX9NUlHlNwZn/trblKyfc5QiERSev99Og7z6yE110YiFe4UrND3lgPmFBkoAvOSZUFp4JFxERPH7A3NtdbPU5Uf8ab718rWxph1MbKXh9wRbvbyT3oNpAhzCrEFnYnHxQz8C3BLAvpX5f3pCHGQ9yIO21d3s6W7e62vg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=utiSV9NY9N1U9EfHhQa7X6vWZDTYhgt2OEmwNAM7eXA=; b=Q1VVUbq3XfIaRAV3ciFZOh++P8PsC/coUENMXHq4Qf5erdfuFMaIf3b5E38fFsm8RkrKEBoucjDAM602c0L1YhcHtlUhl6vtmyabLmXbHIhT1zTMfUSfnB72yo5l1/kzdlW6O+iaUsv6MW+Ljrp7DftlIrCXPdyoc+FdpPDi1bPAtAOSFGOF6m+QIhrbsvfJySQsYGxZ7aQkv4JvHOKHhjxpN2/M+f0oDPKWamX451Ekkq3vP0uIvNDC5Fb88cj4skqo9LQx0mJiEw4M+Akne/HL4K4YEdCF2l6tBI2oTty7sL496XNfZnoDjb8/C3xER21TZYTW2FbRGHCNLaGKMQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 172.205.89.229) smtp.rcpttodomain=sourceware.org smtp.mailfrom=arm.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=arm.com; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=arm.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=utiSV9NY9N1U9EfHhQa7X6vWZDTYhgt2OEmwNAM7eXA=; b=CEacsuOWSY/cFUeaiD5WpRqLw3fANxemj3QhofHkdeqPENO6mFwsuV4SHQTmuivaZFgw+e6pj9Mw15jk6nWqLKFguQ3/4p9TyawfKI4muFXA67PKAwq6cuqoKfoFt/Xl0Qlk8pjW/qpwkqVxFZUdOkGMAqRSNkNPFjK03q0Xx7Y= Received: from DU2PR04CA0299.eurprd04.prod.outlook.com (2603:10a6:10:28c::34) by MI9PR08MB890576.eurprd08.prod.outlook.com (2603:10a6:290:c3::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.339.11; Mon, 24 Aug 2026 13:57:40 +0000 Received: from DU2PEPF00028D12.eurprd03.prod.outlook.com (2603:10a6:10:28c:cafe::37) by DU2PR04CA0299.outlook.office365.com (2603:10a6:10:28c::34) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.21.339.12 via Frontend Transport; Mon, 24 Aug 2026 13:57:40 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 172.205.89.229) smtp.mailfrom=arm.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 172.205.89.229 as permitted sender) receiver=protection.outlook.com; client-ip=172.205.89.229; helo=nebula.arm.com; pr=C Received: from nebula.arm.com (172.205.89.229) by DU2PEPF00028D12.mail.protection.outlook.com (10.167.242.26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.360.3 via Frontend Transport; Mon, 24 Aug 2026 13:57:40 +0000 Received: from AZ-NEU-EXJ02.Arm.com (10.240.25.139) by AZ-NEU-EX03.Arm.com (10.240.25.137) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.29; Mon, 24 Aug 2026 13:57:39 +0000 Received: from AZ-NEU-EX04.Arm.com (10.240.25.138) by AZ-NEU-EXJ02.Arm.com (10.240.25.139) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.29; Mon, 24 Aug 2026 13:57:39 +0000 Received: from PF4S4363.arm.com (10.57.41.87) by mail.arm.com (10.240.25.138) with Microsoft SMTP Server id 15.2.2562.29 via Frontend Transport; Mon, 24 Aug 2026 13:57:38 +0000 From: Matthieu Longo To: CC: Simon Marchi , Matthieu Longo Subject: [PATCH v3] gdbtypes: improve documentation of composite type helpers Date: Mon, 24 Aug 2026 14:57:37 +0100 Message-ID: <20260824135737.415306-1-matthieu.longo@arm.com> X-Mailer: git-send-email 2.55.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: DU2PEPF00028D12:EE_|MI9PR08MB890576:EE_|AMS0EPF000001AC:EE_|PAVPR08MB9795:EE_ X-MS-Office365-Filtering-Correlation-Id: 279919ec-50f8-4ef4-d79b-08df01e7bcaf x-checkrecipientrouted: true NoDisclaimer: true X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Untrusted: BCL:0; ARA:13230040|36860700016|1800799024|82310400026|376014|23010399003|18002099003|11063799006|56012099006|6133799003|10067099003; X-Microsoft-Antispam-Message-Info-Original: CaVAXDKgD0rChlzTNWegrx3wwSLt5A4mqjxKVb+TkRwBbi7CUIVht5FpvKnVtSycYrfwlHdln1xI8uSH5tdQwv+rs4VI/bNUBosqVFym12qfjSSPsngKGLueyFcrh1v5uN7JpPnJ4DLTpu1xOTSUH3WEpE9Plm9eWCaaDJ03sLn33SwQf0Zn+MtALld8r3gNCsZQmTvc0o6lvmERudoECTFIu+JbYR2WhyFQQLbhfLGLhs+aRoJXKiQD8cTa/KTPRgu7644SyrzX8h88nLU3iwsYJ4ei94PWQnW6AKcK9GPuOm0PNQp24fGAdnKvvRn2qUfJsNPRsH5kefvUi//jPdnz0lWpFYHb6EM7fww/soT5W0r0bFv+tnuh7zThhhsxp+CWFohiX2FqTcbG0TFsJCjYhllcszyKussJDCPowiMyK4CKDy+RW5uE9XZdSwbPhW3JyRQDmJ1sYYcEEB21/WkqBlBChDP15WL4TseqofkBGg6i2pnbqs+PO/DM/LI1XTl+8Hyepv/IUYAAmfmfLZlBF91ImMtkoc4QkCGzwyk0SRwicrHFZYnjbDd9ylSs1xQlLmB/R3M/PtILZnlZkNAFSVxoj0tJRMW3NTaVtgpNm6n4Ba4m54eL/aWrkLz4eLBFh8QadycUbh/Gl8XGEUAlFdgWVppxf+gW1aI3V5slz15whFDfOzsLpSf1cNMT2BoimRlUYKXVchsNFVwzgQ== X-Forefront-Antispam-Report-Untrusted: CIP:172.205.89.229; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:nebula.arm.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230040)(36860700016)(1800799024)(82310400026)(376014)(23010399003)(18002099003)(11063799006)(56012099006)(6133799003)(10067099003); DIR:OUT; SFP:1101; X-Exchange-RoutingPolicyChecked: oR6ymr6sMr1zH/Hvuu04ccqvtxSVirdjALDD3XbUsgLm0sqafFtNjf3mdP1skPDUvOm20cICG1RO7YBp8w3RxZJ/U/hRzu+WCzxfd2WVoRUvReVdgnGM4NE1P2Frjn/+xhy7e6IFmdjAdKDHsBzDPw6eW/AdfCsrakCCihVCQ+IMFe/8hCrTCf0jU4LdO/HB1JCnoh+ggFIs5NM6xfcSHbYz5+0W5dgKP1cOPrTiG6H+CtH+29Msb2aQKqOHHVkyHYRKv8EiH4PlbkuhAx8Xt4jKyOOdmPqa3jz5lf9jNiBApkxmjyu7wDWQQVy/b/o5VwvdFpO/alO2DImRxH5E5g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MI9PR08MB890576 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AMS0EPF000001AC.eurprd05.prod.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: 0c21c3b7-2a47-4c8c-7aa1-08df01e7a9c7 X-Microsoft-Antispam: BCL:0; ARA:13230040|1800799024|36860700016|376014|14060799003|35042699022|82310400026|23010399003|10067099003|11063799006|56012099006|6133799003|18002099003; X-Microsoft-Antispam-Message-Info: oSZ1/YgfGO+YrNO3PXtHRq+zgN5T+cp4PRfLIhHzOVQwZPrlxM5yMxYkLLz6f6ymK/kKLRjsElXeDKpt6kNeBPJo8DEY00bpNbHGVF9YTtYfk8sDuDeeX6HL/h0w+Xydp66fg2B+9DMQavuV1ros8iby++Eg5TBUiX+XXHjJhTxwLKDFqNMar++7bO8NRbdam1uLSo5RNzC8q6pMiY1KFd2rloDuA746guC25iCH8uK0lTvyE2HQiNTqi5N9Sz9iriVCnQXC34xHrBNMEq3qGdDFwXglFu1DE5xsY7PKz30ztetwiIbAl0nrivetnDEjXwKt/jjhTlFZkBOO+HzgK3jtXSkIDaFvkiY4yU7yOgIKOzPzAMIVMisbonEdslmdEILIw0wkTqxsnd5ECFaTfdYsM5SW6Vk+hlgwOWb9AfiKZiz43jPmeDfgTyd07v6GZLW4LXQhsXJDyJwt720pqfct6AiP3wukIK6crE9Y1u2pvReiRvghW0KamfoGwLAxQEYFY1McptKeUlPhXYExX880Rw0TlJdk4NixWl/SsSB9Xd2HDFi6e6xYn23lbQx3NRF819gCo82/RHqAzdLO+v7TLBDTiNWmuX4W5sP2/poo+ZUe5urd8rg+OzvFoHkPM4Ik1GOzCUY52xi51f9DTp1//0UgGiezoKc6+2Sl+cwro32Yck/QsegupE9LdFPm2fND42+2pYGVbd7YyHuDIA== X-Forefront-Antispam-Report: CIP:4.158.2.129; CTRY:GB; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:outbound-uk1.az.dlp.m.darktrace.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230040)(1800799024)(36860700016)(376014)(14060799003)(35042699022)(82310400026)(23010399003)(10067099003)(11063799006)(56012099006)(6133799003)(18002099003); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: G4upQA5TNP0W7YgfCZX/4T1jSDS93055o92OW09EVkpEXx4dJztemd7+qFCD042LRMqhe67uSAR3BUo9R68RV7cseagn5gC9pqy81W0uRKMhQHe/H2obw/MGB2GxM165FVHZielN6N/i1fLzxqRORiBlwp/I1akw1tSWu6Ncl8NlK3+GKcPriYV9kyeYD3jZcuIOOK1uVb4OMPYqHUyUwAk/PcjUeCEPbDYODs0CfrATlnxGTvRTNPGLqB0l1m3KDtemFwtD2q2Vi92zI6WGy7c/x4er6kClbLSjfBkghhfimL0Gxfq4STzDVOL2n8WlNA8KFqnVC8iTSEkQU2EswcCzcSqt+QjjS/2RPA6B313B4a2wMQvAJcPFT3qrMpIbPqKEOikXWaDpYmKDHmClvAYbssGjLaNEGzZF1ngJqYExsE3qD4/ZwZ3NXA1tcG+G X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Aug 2026 13:58:12.4215 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 279919ec-50f8-4ef4-d79b-08df01e7bcaf X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[4.158.2.129]; Helo=[outbound-uk1.az.dlp.m.darktrace.com] X-MS-Exchange-CrossTenant-AuthSource: AMS0EPF000001AC.eurprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAVPR08MB9795 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 Document how arch_composite_type handles a null NAME, and clarify the semantics of an empty field name for the append_composite_type* helpers. Suggested-By: Simon Marchi --- gdb/gdbtypes.c | 12 ++++-------- gdb/gdbtypes.h | 33 ++++++++++++++++++++++++++++----- 2 files changed, 32 insertions(+), 13 deletions(-) diff --git a/gdb/gdbtypes.c b/gdb/gdbtypes.c index 4b6c01910f4..e0c25c58d83 100644 --- a/gdb/gdbtypes.c +++ b/gdb/gdbtypes.c @@ -5412,8 +5412,7 @@ append_flags_type_flag (struct type *type, int bitpos, const char *name) name); } -/* Allocate a TYPE_CODE_STRUCT or TYPE_CODE_UNION type structure (as - specified by CODE) associated with GDBARCH. NAME is the type name. */ +/* See gdbtypes.h. */ struct type * arch_composite_type (struct gdbarch *gdbarch, const char *name, @@ -5428,9 +5427,7 @@ arch_composite_type (struct gdbarch *gdbarch, const char *name, return t; } -/* Add new field with name NAME and type FIELD to composite type T. - Do not set the field's position or adjust the type's length; - the caller should do so. Return the new field. */ +/* See gdbtypes.h. */ struct field * append_composite_type_field_raw (struct type *t, const char *name, @@ -5448,8 +5445,7 @@ append_composite_type_field_raw (struct type *t, const char *name, return f; } -/* Add new field with name NAME and type FIELD to composite type T. - ALIGNMENT (if non-zero) specifies the minimum field alignment. */ +/* See gdbtypes.h. */ void append_composite_type_field_aligned (struct type *t, const char *name, @@ -5489,7 +5485,7 @@ append_composite_type_field_aligned (struct type *t, const char *name, } } -/* Add new field with name NAME and type FIELD to composite type T. */ +/* See gdbtypes.h. */ void append_composite_type_field (struct type *t, const char *name, diff --git a/gdb/gdbtypes.h b/gdb/gdbtypes.h index dd2d24fa8e2..b8b6d3751ee 100644 --- a/gdb/gdbtypes.h +++ b/gdb/gdbtypes.h @@ -2431,20 +2431,43 @@ extern struct type *init_pointer_type (type_allocator &alloc, int bit, extern struct type *init_fixed_point_type (type_allocator &, int, int, const char *); -/* Helper functions to construct a struct or record type. An - initially empty type is created using arch_composite_type(). - Fields are then added using append_composite_type_field*(). A union - type has its size set to the largest field. A struct type has each - field packed against the previous. */ +/* Allocate a structure or union type (as specified by CODE) associated with + GDBARCH. + + NAME is the type name. If it is nullptr, the type is anonymous. + + The new type initially has no fields. Fields can be added by calling + append_composite_type_field*. */ extern struct type *arch_composite_type (struct gdbarch *gdbarch, const char *name, enum type_code code); + +/* Add a new field named NAME with type FIELD to composite type T. + + If NAME is an empty string and the field's type is a structure or a union, + the fields of that structure or union are visible directly in T. + + This function updates the size of T: + - A union type has its size set to the largest field. + - A structure type has each field packed against the previous. */ + extern void append_composite_type_field (struct type *t, const char *name, struct type *field); + +/* Like append_composite_type_field, except that ALIGNMENT (if non-zero) + specifies the minimum alignment of the new field. */ + extern void append_composite_type_field_aligned (struct type *t, const char *name, struct type *field, int alignment); + +/* Like append_composite_type_field, except that this function does not + set the field's position or adjust the length of T; the caller is + responsible for doing so. + + Return the newly added field. */ + struct field *append_composite_type_field_raw (struct type *t, const char *name, struct type *field); -- 2.55.0