From patchwork Thu Aug 3 16:31:17 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Qing Zhao X-Patchwork-Id: 130729 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:9f41:0:b0:3e4:2afc:c1 with SMTP id v1csp1266140vqx; Thu, 3 Aug 2023 09:32:14 -0700 (PDT) X-Google-Smtp-Source: APBJJlH5AlLXdDWg7Qn779xQJWSIl7pEXYwyqAQdLG2dmypGNQs2u9svc+gVWhx/I8VQjnKHTgIJ X-Received: by 2002:a17:907:763b:b0:99c:c59:2280 with SMTP id jy27-20020a170907763b00b0099c0c592280mr7783931ejc.51.1691080334432; Thu, 03 Aug 2023 09:32:14 -0700 (PDT) Received: from server2.sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id o2-20020a1709064f8200b0098e1263aadbsi61229eju.100.2023.08.03.09.32.14 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 03 Aug 2023 09:32:14 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=Twke7vq4; arc=fail (signature failed); spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 21A803858404 for ; Thu, 3 Aug 2023 16:32:13 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 21A803858404 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1691080333; bh=sT2mHvD4KZ+gOK0gIgD6ohb+ZBbUgEelqexy1xtvPJw=; h=To:Cc:Subject:Date:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:From; b=Twke7vq4XOTkh9yoqRNxFrV1AwYgGniBTYWSJf6aDzVpXsXE8zB6iyy7USHz+Mf1R DhILOEtvvyRyAW2Hk+skzMMJMtHDy+Gc1tZHkimYqbLT9hjEFVw+QmZbxK6KMfVpyy lV7p+LuUP4ipN6nDOcY21lMmSMFKDfoPZcuhvGso= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by sourceware.org (Postfix) with ESMTPS id C8F7F3858D1E for ; Thu, 3 Aug 2023 16:31:28 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org C8F7F3858D1E Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 373CgaOv015379; Thu, 3 Aug 2023 16:31:27 GMT Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3s4tcu2001-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 03 Aug 2023 16:31:26 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 373FBPVe015684; Thu, 3 Aug 2023 16:31:26 GMT Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2168.outbound.protection.outlook.com [104.47.59.168]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3s4s79w3gv-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 03 Aug 2023 16:31:25 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BY4rEV5ObkZeMiOgcsvusBThiwZPbAogb9H/B23TqYgkvQo6nghHl27NNhnGIwb177b6fjJgqGOkmlaTFOGfKA0wt1KR7wEMPPCp5FeD5FHqBCsk24kpoCWZ/Ew7ClnVpE2iR37Ge2oqqyo0On4RCXC1/TATvJ8GtLqFUdew51Q2GvC8y9a7b7GFx68gv2rnVLFljwR9LBiZiLJ9kK26omtjLEvG5LUhTnPQFcBWXICdfgi28zFWIxXM7UXMmgMXZ4GpiaFgQfQ4IgDZ6LGeqSbXj+PTrkNhBmUcGEryzWbRzd8wHJ+9M0JqUfYnXRmWEA+6xbwxEBRNBtZMabmp8A== 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=sT2mHvD4KZ+gOK0gIgD6ohb+ZBbUgEelqexy1xtvPJw=; b=VQJWpIqj2jtGRKDMQSUwJzAiyI2k3a0Sg830eu2Ig+6MAMRYlmZjc2hsvf1w/V8Q3q+Df+YJus0Ihc0xTwryRv9V9BeeQCAh8VOklN/rnJSy3A+9URHxwCbONaOmVazXzVdJ7Z+W3T5KZoIs8bNFgpsph9kqxmsps+u9aM/f7TuM8D6tgHJGPJ/ytDu/InmmiZXElz/uTflRdnhHcC9BFUZi32V7JkDfdjIUWDX8lJqxjUSUuI5BUIZ1xRTsgowfjoEVScZK0aBt2wb/MjIeR3Hbw2zUQLvzACX0IM6+QZWHmlz/qvqhNWWdYF2gEue30dXfkiIC+BXqAio0d8NSnQ== 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 Received: from MN2PR10MB4349.namprd10.prod.outlook.com (2603:10b6:208:1d4::9) by DS0PR10MB7068.namprd10.prod.outlook.com (2603:10b6:8:144::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6631.47; Thu, 3 Aug 2023 16:31:23 +0000 Received: from MN2PR10MB4349.namprd10.prod.outlook.com ([fe80::ff87:cfff:8da2:cd13]) by MN2PR10MB4349.namprd10.prod.outlook.com ([fe80::ff87:cfff:8da2:cd13%2]) with mapi id 15.20.6652.020; Thu, 3 Aug 2023 16:31:23 +0000 To: richard.guenther@gmail.com, joseph@codesourcery.com Cc: gcc-patches@gcc.gnu.org, Qing Zhao Subject: [PATCH] Add documentation for -Wflex-array-member-not-at-end. Date: Thu, 3 Aug 2023 16:31:17 +0000 Message-Id: <20230803163117.1016079-1-qing.zhao@oracle.com> X-Mailer: git-send-email 2.31.1 X-ClientProxiedBy: LO4P123CA0556.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:33b::6) To MN2PR10MB4349.namprd10.prod.outlook.com (2603:10b6:208:1d4::9) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MN2PR10MB4349:EE_|DS0PR10MB7068:EE_ X-MS-Office365-Filtering-Correlation-Id: 851047dc-23a1-4ada-bf7c-08db943f138a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: r0LKP/+AkJavdRR1cw4XymtcOTEwwLS//7xbHlijd6X3ooouWv4wbP4Gv7QuEMrUTrRb63iDNpggBaL43p/6Ouj7KgyslaPXWgifK7VygBmWQFlJBCZ0gWf7V5XL7JnnAOegOVDhUb3KpYv2K+OAP7p+UkavcVBn9aUt2qSUfMURYFKDMrJPxGxqvwG94ZOsAiEUCBedjOxyaf/BHoEKae9rN9HrLbRr/U4HtJQTVpl2QISla6Q0OoEbrYNtP0X+d8U0vkJC8Xsx2MMO4T4eZWQMgUihJKjFiV3i8xxBa097q/fiia81nak/DadNtK6ZPgrW2w5hkZxmMtkeHEHXHPYDe0yoZYsIRN/Jm/DhEJvO2hM8DpSfPkgIWNhUSzGbRJn+lqbIcpbKMezd/3AnU+PftAw7E4YCyflV93ieeX6/B+IL2FuopV7wyX/FVr32nWReH75x6rXEnBVOGj6bPrc8wH4ZqcPBfYRwchyJa1Tg6GkB7ZX4kWZe2diYybHRSbJo/kmsQNKxE7U65CBgIGpk2YidQNvftTQMDh5coHM= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR10MB4349.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230028)(39860400002)(136003)(346002)(396003)(366004)(376002)(451199021)(2616005)(1076003)(107886003)(6506007)(83380400001)(186003)(26005)(8676002)(316002)(66556008)(2906002)(4326008)(66946007)(5660300002)(66476007)(41300700001)(44832011)(8936002)(6486002)(6666004)(966005)(6512007)(478600001)(38100700002)(86362001)(36756003); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: UQqNtE8VCDMI9Vn+cjXqx35FJQqloBxVk6sz86euVFIouW6HCQQDVjLU+RpL0+Bn1XabwxJn2+v+k4VTwLkQkRbMbw8yTlURquNuj/+65lGCp8Yk/iwiHP/Y+sHsenkU2Q4mD73uZ5OX56IWMkgVPkI2GeYXqzEgo87cS3K3zESwSRfeKKGUF9DOy8urgWn4u1bpgHYUm66P2xgQmOfQM8nl3P3bOnonK7CEVg68DFLHs/zRTjJCry0SFvLw+QClhpuKd+KBEnT0QHdboBpLVOUEUjHJVXIr48ioQAo6RqkRyBhU025pd5lqwmzhag2uxvHKLe8+gM/vKsyYuZGDvEPqeBxHgjOfw5fLqYyw2vCZB+ue8DvuaFwhAJC5Kx9/TantR+n/6BLv9IQgPShnTvLySLs7Wuf6zTiUAhjpNj/JjjABRKR1gt+fRmOhOv8hLJwwUB5OL3qV3n+Ivdc92czxisvUCD2qVdAY9SQwQRrdhp9bULMppdahjBndWOqETSG83FfFyoD72BFFLyPbcYIeWjLvZ4eQLqdAk0Eo5ceohfVZa/7R1wzuI1bC2F1VlYLYUbkJOch/gv+8DSY1pczYJHFEsPokv0RUxTf4M6E75KMSVnwrn9WWBwdhW7f/Qt6rMPWfuTs8ikhbrvlZ6rpsCU9EwgM/rq8o4DIe4A83V5rj0XsQUiTD5x4Bgm7jWJ6yQTvbnj7YoJfWlbdJWFGI+65TebZUEOXSnRtsXjbQbpoP9iex1pAUMygGrzbfbO8y3RJLOA8STTO9ACRFSZXHrjyEAlVUhmOGslvRjN+C+eQfs0NsrM1rjnry4mtMpglDTp+d+VT1+TSMHCDNMdiGHlNUFwj/e0uRT91kgZqg4UTyHnfLrIjgwQrt0iC9lrpKpg480eK96nBB00LC2H3byyVyrTVy772wgwK2l8xgXzz2gCAOAXGBQJjqZyU/GGA5QTV2VatbHtEnDq70CJo42DTLnydCB/CP9isvMuSSUEUUrobsIogNyi9MAlv5708SId/Hk9kYvHLiwyc12BrdJaQuY+HkC1T3Vxz36JQf+QstunuYcdCr7HNc3Ww7UYRbPLkt3pUcM5HHhfspkyRkjcu/leF/gMyuNcn1IJykWUnPkYdawG+LLCkV/CTa3nj10MrluCdtZndEBSgu2q9wiOdUaACpD73r8YYOwHzCdgw0mophn1ZyEpFMJZDknkkFItuI8gaooFfYbOfW/i6x5YNiN4QsCZtZPYULysHOSh/44kgHySrjz1zAyDwV3kfzYigkDQ5FU9t0tPK7/2bg+/SlNuPks2P447tgE2z9c+NmVEndKklO3kcbmJpWUIaqH8srDBy/+c7ohwLJlVkS0KHtz5v66wd8UoEgHf91bExTOoa3DMclrISd9Ohrn6HknWaHcyDMRuCD10M/PCozUdfUcvioOHmOT4FrHtP1FFZDblDclBO/U0DE+tL2Stw4AP6soIBCu5v3djnpowu96yORM9J/1QkHRLsMITyPkJBDboVLsrqC6ukNG2xf/O9I2QDUAe/hQ48Z/TCExX7Vkt58Bvnxl1NSQUQxpEFfnU4Wu0bKlC4kHE0CSiqG X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: rwLpNSLPXG0ZhyMbEKsuPyc7Wj2tTDFnztF29ckhRrJ75aK7KQ41EWlVKTvIHvFL85lLM3YArBj3og868DzB0McJIZNRR9BhYP+pUinLm0UZIzlm/3R7NvimW9qAlmdvEnxUTQXtZhQLnprBtIY1O7vBDkb/gQ9t9pqMwYkXNu0ECGzCtNL49vr2klIplosQ3JuemLm8E0x01FdCWFdAVR5x77JxFqmdgVrXBunC1ECcIGlOtTKyi7BhRUtBEYo6XSLpQZvqQiU0BFWutXP1gAH9nuzsBX2ezIZKAPP9y4fOhq/EaSGXK8oUypGWFtanFyAUUY24uui7S1DOXDx2agjc1IRQhWn8ThsLPltkrZqFChNgyUCkX36ZvUoge5pz3wUNwWm4TbyR+QNo6UEBMT91DExi/p5azZeHrkDjmn67PhfCtjbo1fMFnRhj9uZ7xRNg8eI1Gtk/KY+mrCQA8dOasBcoUQRav1xubzdTd7hKZxYFxmT5d2OvT0Of0oB/qvZ/CCKCg1gTCW1WUcyiIWOm61jgE7kn9IIhFTE9DTNy7+zxom/eygMOYYmax45u6pRIOXBHnVDozHOieqYZSC3xjZGtnVLTLRcNhpLkJCgD4naf96Yn3gyL/DPsmEMhLnLbLmzaxPmW849KT9MP7X4CJJE1bdqMp9DujiXzL8lf7ZWHNPjRJ14iTi5IzlO+dy/1N0FXY8defqTPeXz3D6GIG7LyR0C8ziekjtL7JSvop7QZYXk3bznx/T1LvY5iDPJwqkDIAfTA1yJbGnZf2vCzbah67bBrzsG7m0gC8DOCcMYapUyitIixcqsybq3D X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 851047dc-23a1-4ada-bf7c-08db943f138a X-MS-Exchange-CrossTenant-AuthSource: MN2PR10MB4349.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Aug 2023 16:31:23.6662 (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: 0a/plTDeHwP/7Y69r9+qfnSt2K7Tv8SGLPOOkutXrKDIeTinx5b5Q8ea3N3vMDV/fAHCBt7Xu9xzLRVD1IH02A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS0PR10MB7068 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.591,FMLib:17.11.176.26 definitions=2023-08-03_17,2023-08-03_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=905 malwarescore=0 adultscore=0 bulkscore=0 suspectscore=0 spamscore=0 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2306200000 definitions=main-2308030148 X-Proofpoint-GUID: j1X5X655_bWObq2OxYlh-JZqAWJ5X2BD X-Proofpoint-ORIG-GUID: j1X5X655_bWObq2OxYlh-JZqAWJ5X2BD X-Spam-Status: No, score=-11.0 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_SHORT, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H5, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Qing Zhao via Gcc-patches From: Qing Zhao Reply-To: Qing Zhao Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1773226253092826156 X-GMAIL-MSGID: 1773226253092826156 When adding the option -Wflex-array-member-not-at-end in the commit https://gcc.gnu.org/pipermail/gcc-cvs/2023-June/385730.html the documentation for this new option was missing. This patch is to add the documentation for this warning option. bootstrapped and also checked the documentation, no issue. Okay for committing? thanks. Qing ============================== '-Wflex-array-member-not-at-end' Warn when a structure containing a C99 flexible array member as the last field is not at the end of another structure. This warning warns e.g. about struct flex { int length; char data[]; }; struct mid_flex { int m; struct flex flex_data; int n; }; gcc/ChangeLog: * doc/invoke.texi (-Wflex-array-member-not-at-end): Document new option. --- gcc/doc/invoke.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index adb10a3528da..0e7d827d355f 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -357,6 +357,7 @@ Objective-C and Objective-C++ Dialects}. -Wempty-body -Wno-endif-labels -Wenum-compare -Wenum-conversion -Wenum-int-mismatch -Werror -Werror=* -Wexpansion-to-defined -Wfatal-errors +-Wflex-array-member-not-at-end -Wfloat-conversion -Wfloat-equal -Wformat -Wformat=2 -Wno-format-contains-nul -Wno-format-extra-args -Wformat-nonliteral -Wformat-overflow=@var{n} @@ -9312,6 +9313,18 @@ value, like assigning a signed integer expression to an unsigned integer variable. An explicit cast silences the warning. In C, this option is enabled also by @option{-Wconversion}. +@opindex Wflex-array-member-not-at-end +@opindex Wno-flex-array-member-not-at-end +@item -Wflex-array-member-not-at-end +Warn when a structure containing a C99 flexible array member as the last +field is not at the end of another structure. +This warning warns e.g. about + +@smallexample +struct flex @{ int length; char data[]; @}; +struct mid_flex @{ int m; struct flex flex_data; int n; @}; +@end smallexample + @opindex Wfloat-conversion @opindex Wno-float-conversion @item -Wfloat-conversion