From patchwork Mon Apr 8 10:34:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Malcomson X-Patchwork-Id: 1920773 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=armh.onmicrosoft.com header.i=@armh.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-armh-onmicrosoft-com header.b=hm3rET3b; dkim=pass (1024-bit key) header.d=armh.onmicrosoft.com header.i=@armh.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-armh-onmicrosoft-com header.b=hm3rET3b; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=2620:52:3:1:0:246e:9693:128c; helo=server2.sourceware.org; envelope-from=gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=patchwork.ozlabs.org) Received: from server2.sourceware.org (server2.sourceware.org [IPv6:2620:52:3:1:0:246e:9693:128c]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4VCls42CjPz1yY8 for ; Mon, 8 Apr 2024 20:37:11 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 483DD3858426 for ; Mon, 8 Apr 2024 10:37:09 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from EUR01-DB5-obe.outbound.protection.outlook.com (mail-db5eur01on2089.outbound.protection.outlook.com [40.107.15.89]) by sourceware.org (Postfix) with ESMTPS id 4D2BC3858D20 for ; Mon, 8 Apr 2024 10:36:43 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 4D2BC3858D20 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 4D2BC3858D20 Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=40.107.15.89 ARC-Seal: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1712572606; cv=pass; b=uFE9PyWHqYleBXUbIwcmHHAun73YWv6uJwSBn8NKWiospoMYiFRzU+/4eWglw+wPQo3q/oBPr7VlCtOOlXvcpXe+XsHV98X6J5bxatvYYXhxOI1P3y8eeglISHX0h9DVjWaiRnUQgyEf30lm54q6mR8ft+tmYgw1DpjccfgS4AI= ARC-Message-Signature: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1712572606; c=relaxed/simple; bh=nSIAf7/YuA/xMI9tpXhXinQwY9EMRGnrsPcHm5dQ0Gk=; h=DKIM-Signature:DKIM-Signature:MIME-Version:From:To:Subject:Date: Message-ID; b=ZsjMTIiHufytzK83smUvlFuuEp/8f9InG1pjquxYtRrrXUisjjHbntPQx1koaiZ+VidEW/z3Aad+HByNi+KAcK7IkoyAoGVyvSKDnaBXjuirQaqdcoyWw3ypKt/rDi+u3lAugMreKA1x7MHKYauXLXa+MIzLBpLhk0e2Z95v2zg= ARC-Authentication-Results: i=3; server2.sourceware.org ARC-Seal: i=2; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=pass; b=NnvYIt41brS3dL++fxJuaMlpYN9TFz9cY6ci7X2i9FqsGcGbtkawjzHUOGF670sr1snuwVkyIbPITqiwZsI/wnns/tMevj8+3i7MMAZUi31IJICS7NiAaHDDCw94yxN5zbCIajP4wPmEvX86vZy74V1zdC6INgVZHZAoWlGd0bqD63R3bnSgUrdg/L8eEPtA++ydK91WVHcYVwBqWaSIVeGYeW6Z2Zj2N1P7qGlZXllVscOirvh+UDRHvIu39W2wXC5q0sGbchjwXR8pOIklVm7uz7PgMBrC9coX3rQxTKNLru/QfpHuYq7zDNbGDentoST6ZzE1FTbO0O5rASmQGA== ARC-Message-Signature: i=2; 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=3MsIcBGBfU1QoRtRNxcDHFHJrSCli/lsOjSep/mFBfU=; b=FlMEDe+gVCUV4ppzsV/xlHnir2OVW4Abo4le0yna4DcExYGKwT2HWNOepncjXyqZKsBoeDQLMl2VhMk7YiwoDLdCV+xrcQ+03nv129qNS/qirZiCsg4ucC8ELusIDzC8goFSG0A/CESAE+mK2vK0/Mrx1tBZzOwTDPnWxVlrS6v272SmNoFABo1eiY6QZW5yNfLo4Btxqh0mBG0vG/V52QYfoI8Nw+VAD9Pts+Cf8gqan/FMIYk4JB75VrzYci8yvFZVNx3sqr5TTzEDSg42n4ygrB+cZ81Vdk4wM0MMquan5dyzPWoe7sCObnYoQvoH/3f9Qy/Kg+tzobZ+cLENeg== ARC-Authentication-Results: i=2; mx.microsoft.com 1; spf=pass (sender ip is 63.35.35.123) smtp.rcpttodomain=gcc.gnu.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=armh.onmicrosoft.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=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3MsIcBGBfU1QoRtRNxcDHFHJrSCli/lsOjSep/mFBfU=; b=hm3rET3bgNFgWQ28FP5JbkqjKvJsQuLp4pfNp5SeoID+YnAAbPtyacYkfEH5Lo23m8FrbIO9/50lGU7csdjFXwvWwwOenIK9YE5C2+OKV80EnqUJfAaBLJpTwjHUH5kQqL2AsSRiEiHsYJCKlVHLbhnh9Bp0Dt5xqD8Fo6SnOpc= Received: from AS4P195CA0017.EURP195.PROD.OUTLOOK.COM (2603:10a6:20b:5d6::8) by AS8PR08MB8136.eurprd08.prod.outlook.com (2603:10a6:20b:561::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.46; Mon, 8 Apr 2024 10:36:39 +0000 Received: from AM4PEPF00025F9C.EURPRD83.prod.outlook.com (2603:10a6:20b:5d6:cafe::e6) by AS4P195CA0017.outlook.office365.com (2603:10a6:20b:5d6::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7452.35 via Frontend Transport; Mon, 8 Apr 2024 10:36:39 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; pr=C Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by AM4PEPF00025F9C.mail.protection.outlook.com (10.167.16.11) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.20.7495.0 via Frontend Transport; Mon, 8 Apr 2024 10:36:39 +0000 Received: ("Tessian outbound 1b0f2681ce6f:v300"); Mon, 08 Apr 2024 10:36:39 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: d359ea8ad21c01f7 X-CR-MTA-TID: 64aa7808 Received: from ac9e7416b9cf.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 0CE7AD5D-EA1D-4715-98B6-D6DD36AE50F9.1; Mon, 08 Apr 2024 10:34:54 +0000 Received: from EUR05-AM6-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id ac9e7416b9cf.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 08 Apr 2024 10:34:54 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MtyLvkATd5LCDLRBZaZFPnU7c5wB6+0t9eEzjHoLugpcShRtcP0IffnTsgilzdOSAYH2V4/Vf2GwsQDmX8VIDEnw4M0D5qeYF8AxvC1unUvTmffw3HOWLs4HqRCjIYOnKpdBcwTtKk86MDitXSbcaBLYAOey02ox2GC5Vc7l8kGCCTdnyli2MDmdNBgqIpc6+dU7x2DEHvBFUutwcmGzlLnGYoLsAV7onSofic68UXJjpJwKtf6dOm73krRpcQNFGv5j3jtHcGhvp0kuCNKduA8V0zJy0VoqKICUXwk2SZk6/4Ma2ktWDsnpO2diKq2d9mByYV1WDDj/iB/bscFHFg== 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=3MsIcBGBfU1QoRtRNxcDHFHJrSCli/lsOjSep/mFBfU=; b=bzZvLf/bso2440EyT/Vp8cwIWz97CowUzGfZmiiWTGjud6iwvxwBMlEqgdS7vXpO5ymyVhwPCPq4OYltb9xKmlukzzY89P47AvgsL7qPfZbwEogJKPwq9FlDkIhj2mBONAKMR3tFp0mj5q9WZSg5daXj2j11N5lw86ig1ld+7rL064lNWN2m8NNVUsGAbRDliBPtqVLQaUVdQMcv2J8lXcSFcyCsHw63m9SU+UQb0qo5d0QD7AjQ+FgCuRSYyerC+uMtCzOE6s++O2Bzv5UdgaHaSSbYvxyN4lnvHuaf+p2DLo50mZI6Rqsu31pW8K8VRG3OKWy8bFmzMSi9YIb/+Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=gcc.gnu.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=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3MsIcBGBfU1QoRtRNxcDHFHJrSCli/lsOjSep/mFBfU=; b=hm3rET3bgNFgWQ28FP5JbkqjKvJsQuLp4pfNp5SeoID+YnAAbPtyacYkfEH5Lo23m8FrbIO9/50lGU7csdjFXwvWwwOenIK9YE5C2+OKV80EnqUJfAaBLJpTwjHUH5kQqL2AsSRiEiHsYJCKlVHLbhnh9Bp0Dt5xqD8Fo6SnOpc= Received: from AM6PR0202CA0061.eurprd02.prod.outlook.com (2603:10a6:20b:3a::38) by AM9PR08MB6307.eurprd08.prod.outlook.com (2603:10a6:20b:2dc::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.46; Mon, 8 Apr 2024 10:34:47 +0000 Received: from AMS0EPF000001A5.eurprd05.prod.outlook.com (2603:10a6:20b:3a:cafe::dc) by AM6PR0202CA0061.outlook.office365.com (2603:10a6:20b:3a::38) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7452.35 via Frontend Transport; Mon, 8 Apr 2024 10:34:47 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) 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 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; pr=C Received: from nebula.arm.com (40.67.248.234) by AMS0EPF000001A5.mail.protection.outlook.com (10.167.16.232) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7452.22 via Frontend Transport; Mon, 8 Apr 2024 10:34:47 +0000 Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Mon, 8 Apr 2024 10:34:46 +0000 Received: from e120487.cambridge.arm.com (10.2.78.49) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35 via Frontend Transport; Mon, 8 Apr 2024 10:34:46 +0000 MIME-Version: 1.0 From: Matthew Malcomson To: CC: , , Subject: gcc: docs: Fix documentation of two hooks Date: Mon, 8 Apr 2024 11:34:45 +0100 Message-ID: <359b3b28-7e3f-49eb-816b-a1639c2e01cb@AZ-NEU-EX03.Arm.com> X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: AMS0EPF000001A5:EE_|AM9PR08MB6307:EE_|AM4PEPF00025F9C:EE_|AS8PR08MB8136:EE_ X-MS-Office365-Filtering-Correlation-Id: 9ddc63bb-4c83-4741-d1bb-08dc57b7c608 x-checkrecipientrouted: true NoDisclaimer: true X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: ONX5nFkMaH9JN7mnkbuleCnHZ4+lrMcxTgR+cHGrt+1Ei8Nglxp03t4S0EGNsWvcV5izO1X4kYKDxVyjBxETEYeUCtiCz0GLx9Fkiq8PPQSQg2rhmyg9sAd+05l7fQVmlXT4QxILMNAeM1zE7aRImq3tICiNdIfrN77qFOk1Y2dnyB4tQlMBBCLL9MqeLWurEzXLOyefffnxrDNHcVsv6VDM3rZIpcl1Gn0usrHdd17+9nD4UuuNe5tAIv1gmO7MO8EU0j/Ujt+vwDI5u21UFU7NO2Q/YOj0sKjEcUXNdv9T3w75+KNwY/0o+rlw49e1P24n+rpSjKH6hAVUUSw1KvBH8C9sEX+9qpotmwvUiTOPjikVwn14HQ5VrBBIMCQfLXEUGy4wuRbowvEAR9JVApGyKUsrdKE1ra5w7GHzuWufCadspumh46lQfdfLoqZ6MDZOQdB/vgdOo5CvpcXamA2WzHxo82MX+Ibs1H5VRvfIkCmVsh8CHkhG1NULv0sdWc/55AZ6AeeWsfmF5nLcbFC4qh+Mt2BJYHA664/70C7mLnChwyi6+Vy5MRldMlmzVhuuOV6Nlj9hQi8T01uASrwAF5QESDkjz3FsnT9r8pN+DpngwnnMzHvuB1MIoqYZCx1sm4lILCsbsAttwXOINsPgNWPq5Jfqy8/6WqwDFE4pa/ORU/hoMPc5XG3qgnLdxRmCNe/uNIeYCXzcJHHUnyzr94RJV0paAQOM1EAdqLZ7TlJ2tZS8+y6yR+LfQ0PT X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:nebula.arm.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230031)(1800799015)(36860700004)(376005)(82310400014); DIR:OUT; SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9PR08MB6307 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM4PEPF00025F9C.EURPRD83.prod.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: f0146f9c-45ab-453f-b2a3-08dc57b78344 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: xnyZD3X2gOH9aBATEIJR/LYtmFvWfhzb2SIe4CKI6BMdnm4waSER0uLz6q48sM1+iBixjJRygkJ7LK+fpc9HdunA2VVp+lpccByrgybJDz2At5OoE1sa/VoneNpu1XUSu52sTg1OAMRa0cK/dIvTHnh3a9Zp388hq69wmOpblWcscSLDgtEGfBLE5elv+r90cWTNeIVbZ0izlc5zOjpd/qyZNwNPqKJ2zwdrpNi+aSYp7fh6fxkvQ86Ofoz9lIajKZDHeOy9Wvww1MGurJRyf9hfwHgLh0xVwZHWdfQI9BZqnruswcRJfZUFhUXWwEsDOG403dAcuEmtk3ZW7oRPNfJER3nQhWAjBAsB1EktMoG0nOAoTt1jYTpPaxCAEwBDHOchV0OOcjouNvTC1uItcjLXzPzv3a64Q2PNhqopH6VjbaUj7Oz+o0I+x6JUd9RP39F3GCHijJbwCezmUw7FkOYt3A8uzXkSlUa7ac0lvnKLc4R9Jt76X56Oxjwrb1BaMpuTQrqWzedvIs0wffB4La3ip5GpZrh1x2ZLjnQyQD0RxS/unxfPDoH/WCnLCfge42OQ1ZYJTttxCyMjZyVzeJ+LVIKLPwdlljSOOSq2U9OSmFmGw4aYCXz+NTAUvuK8m5m7FtEO4u8GMNAK6G+MdjXNXri5fGulmRGc+VyspCXnJ+4Y8+bWaxbqEmQp/cftTgjFRw6tXJUj9fnhgFqeQZuBCspgqEXIweTgbDIdCyr27s/kAp0fzdtTlm1xezUX X-Forefront-Antispam-Report: CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com; PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFS:(13230031)(1800799015)(36860700004)(376005)(82310400014); DIR:OUT; SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Apr 2024 10:36:39.2084 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 9ddc63bb-4c83-4741-d1bb-08dc57b7c608 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123]; Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: AM4PEPF00025F9C.EURPRD83.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR08MB8136 X-Spam-Status: No, score=-12.0 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, FORGED_SPF_HELO, GIT_PATCH_0, KAM_DMARC_NONE, KAM_LOTSOFHASH, RCVD_IN_MSPIKE_H2, SPF_HELO_PASS, SPF_NONE, TXREP, UNPARSEABLE_RELAY 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.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org The `function_attribute_inlinable_p` hook documentation described it returning the value if it is OK to inline the provided fndecl into "the current function". AFAICS This hook is only called when `current_function_decl` is the same as the `fndecl` argument that the hook is given, hence asking whether `fndecl` can be inlined into "the current function" doesn't make sense. Update the documentation to match this understanding. The `unspec_may_trap_p` documentation mentioned applying to either `unspec` or `unspec_volatile`. AFAICS this hook is only used for `unspec` codes since c84a808e493a, so I removed the mention of `unspec_volatile`. gcc/ChangeLog: * doc/tm.texi (function_attribute_inlinable_p, unspec_may_trap_p): Update documentation. * target.def (function_attribute_inlinable_p, unspec_may_trap_p): Update documentation. ------------------------------ N.b. not entirely sure who to ask for review, went with docs maintainers, but if that's incorrect please do redirect me. ############### Attachment also inlined for ease of reply ############### diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index c8b8b126b2424b6552f824ba42ac329cfaf84d84..f0051f0ae1e9444d5d585135c90a68ca760c2fbd 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -10752,10 +10752,10 @@ attribute handlers. So far this only affects the @var{noinit} and @deftypefn {Target Hook} bool TARGET_FUNCTION_ATTRIBUTE_INLINABLE_P (const_tree @var{fndecl}) @cindex inlining -This target hook returns @code{true} if it is OK to inline @var{fndecl} -into the current function, despite its having target-specific -attributes, @code{false} otherwise. By default, if a function has a -target specific attribute attached to it, it will not be inlined. +This target hook returns @code{false} if the target-specific attributes on +@var{fndecl} always block it getting inlined, @code{true} otherwise. By +default, if a function has a target specific attribute attached to it, it +will not be inlined. @end deftypefn @deftypefn {Target Hook} bool TARGET_OPTION_VALID_ATTRIBUTE_P (tree @var{fndecl}, tree @var{name}, tree @var{args}, int @var{flags}) @@ -12245,12 +12245,10 @@ allocation. @end deftypefn @deftypefn {Target Hook} int TARGET_UNSPEC_MAY_TRAP_P (const_rtx @var{x}, unsigned @var{flags}) -This target hook returns nonzero if @var{x}, an @code{unspec} or -@code{unspec_volatile} operation, might cause a trap. Targets can use -this hook to enhance precision of analysis for @code{unspec} and -@code{unspec_volatile} operations. You may call @code{may_trap_p_1} -to analyze inner elements of @var{x} in which case @var{flags} should be -passed along. +This target hook returns nonzero if @var{x}, an @code{unspec} might cause +a trap. Targets can use this hook to enhance precision of analysis for +@code{unspec} operations. You may call @code{may_trap_p_1} to analyze inner +elements of @var{x} in which case @var{flags} should be passed along. @end deftypefn @deftypefn {Target Hook} void TARGET_SET_CURRENT_FUNCTION (tree @var{decl}) diff --git a/gcc/target.def b/gcc/target.def index fdad7bbc93e2ad8aea30336d5cd4af67801e9c74..2b2a6c11807eff228788fae1cd1370e8971fbf3e 100644 --- a/gcc/target.def +++ b/gcc/target.def @@ -2314,10 +2314,10 @@ attribute handlers. So far this only affects the @var{noinit} and\n\ DEFHOOK (function_attribute_inlinable_p, "@cindex inlining\n\ -This target hook returns @code{true} if it is OK to inline @var{fndecl}\n\ -into the current function, despite its having target-specific\n\ -attributes, @code{false} otherwise. By default, if a function has a\n\ -target specific attribute attached to it, it will not be inlined.", +This target hook returns @code{false} if the target-specific attributes on\n\ +@var{fndecl} always block it getting inlined, @code{true} otherwise. By\n\ +default, if a function has a target specific attribute attached to it, it\n\ +will not be inlined.", bool, (const_tree fndecl), hook_bool_const_tree_false) @@ -4057,12 +4057,10 @@ allocation.", FLAGS has the same meaning as in rtlanal.cc: may_trap_p_1. */ DEFHOOK (unspec_may_trap_p, - "This target hook returns nonzero if @var{x}, an @code{unspec} or\n\ -@code{unspec_volatile} operation, might cause a trap. Targets can use\n\ -this hook to enhance precision of analysis for @code{unspec} and\n\ -@code{unspec_volatile} operations. You may call @code{may_trap_p_1}\n\ -to analyze inner elements of @var{x} in which case @var{flags} should be\n\ -passed along.", + "This target hook returns nonzero if @var{x}, an @code{unspec} might cause\n\ +a trap. Targets can use this hook to enhance precision of analysis for\n\ +@code{unspec} operations. You may call @code{may_trap_p_1} to analyze inner\n\ +elements of @var{x} in which case @var{flags} should be passed along.", int, (const_rtx x, unsigned flags), default_unspec_may_trap_p) diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index c8b8b126b2424b6552f824ba42ac329cfaf84d84..f0051f0ae1e9444d5d585135c90a68ca760c2fbd 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -10752,10 +10752,10 @@ attribute handlers. So far this only affects the @var{noinit} and @deftypefn {Target Hook} bool TARGET_FUNCTION_ATTRIBUTE_INLINABLE_P (const_tree @var{fndecl}) @cindex inlining -This target hook returns @code{true} if it is OK to inline @var{fndecl} -into the current function, despite its having target-specific -attributes, @code{false} otherwise. By default, if a function has a -target specific attribute attached to it, it will not be inlined. +This target hook returns @code{false} if the target-specific attributes on +@var{fndecl} always block it getting inlined, @code{true} otherwise. By +default, if a function has a target specific attribute attached to it, it +will not be inlined. @end deftypefn @deftypefn {Target Hook} bool TARGET_OPTION_VALID_ATTRIBUTE_P (tree @var{fndecl}, tree @var{name}, tree @var{args}, int @var{flags}) @@ -12245,12 +12245,10 @@ allocation. @end deftypefn @deftypefn {Target Hook} int TARGET_UNSPEC_MAY_TRAP_P (const_rtx @var{x}, unsigned @var{flags}) -This target hook returns nonzero if @var{x}, an @code{unspec} or -@code{unspec_volatile} operation, might cause a trap. Targets can use -this hook to enhance precision of analysis for @code{unspec} and -@code{unspec_volatile} operations. You may call @code{may_trap_p_1} -to analyze inner elements of @var{x} in which case @var{flags} should be -passed along. +This target hook returns nonzero if @var{x}, an @code{unspec} might cause +a trap. Targets can use this hook to enhance precision of analysis for +@code{unspec} operations. You may call @code{may_trap_p_1} to analyze inner +elements of @var{x} in which case @var{flags} should be passed along. @end deftypefn @deftypefn {Target Hook} void TARGET_SET_CURRENT_FUNCTION (tree @var{decl}) diff --git a/gcc/target.def b/gcc/target.def index fdad7bbc93e2ad8aea30336d5cd4af67801e9c74..2b2a6c11807eff228788fae1cd1370e8971fbf3e 100644 --- a/gcc/target.def +++ b/gcc/target.def @@ -2314,10 +2314,10 @@ attribute handlers. So far this only affects the @var{noinit} and\n\ DEFHOOK (function_attribute_inlinable_p, "@cindex inlining\n\ -This target hook returns @code{true} if it is OK to inline @var{fndecl}\n\ -into the current function, despite its having target-specific\n\ -attributes, @code{false} otherwise. By default, if a function has a\n\ -target specific attribute attached to it, it will not be inlined.", +This target hook returns @code{false} if the target-specific attributes on\n\ +@var{fndecl} always block it getting inlined, @code{true} otherwise. By\n\ +default, if a function has a target specific attribute attached to it, it\n\ +will not be inlined.", bool, (const_tree fndecl), hook_bool_const_tree_false) @@ -4057,12 +4057,10 @@ allocation.", FLAGS has the same meaning as in rtlanal.cc: may_trap_p_1. */ DEFHOOK (unspec_may_trap_p, - "This target hook returns nonzero if @var{x}, an @code{unspec} or\n\ -@code{unspec_volatile} operation, might cause a trap. Targets can use\n\ -this hook to enhance precision of analysis for @code{unspec} and\n\ -@code{unspec_volatile} operations. You may call @code{may_trap_p_1}\n\ -to analyze inner elements of @var{x} in which case @var{flags} should be\n\ -passed along.", + "This target hook returns nonzero if @var{x}, an @code{unspec} might cause\n\ +a trap. Targets can use this hook to enhance precision of analysis for\n\ +@code{unspec} operations. You may call @code{may_trap_p_1} to analyze inner\n\ +elements of @var{x} in which case @var{flags} should be passed along.", int, (const_rtx x, unsigned flags), default_unspec_may_trap_p)