From patchwork Sun Dec 7 00:10:14 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 126069 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id D1FA6414073C for ; Sun, 7 Dec 2025 00:14:21 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-ot1-f65.google.com (mail-ot1-f65.google.com [209.85.210.65]) by sourceware.org (Postfix) with ESMTPS id AC7E7414373B for ; Sun, 7 Dec 2025 00:10:47 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org AC7E7414373B Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=baylibre.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org AC7E7414373B Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=209.85.210.65 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1765066247; cv=none; b=YyrvfKQpUgjFvHLMt6ljwai7KzACYzt9QsIC0h/LYTeXsaLUZCLCQYHtCX5uT26xxYvChWBKTryZc1SJQyDOEF4Jfu7LkzftoAVgpvgjIPc0czrfCjulsNzfUyojToAnzzDXOYFWU6ENXeA9jaMocxGQ0pioaN+tUXLj3dsKgnA= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1765066247; c=relaxed/simple; bh=6/x4UIEuqpgA2+EwJbGepOm2MEac8zl9COD/vEG6OaI=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=tMfBYIjB/jTkcQUXGF1ow5gxzH+BS4iD5USJtsxlgqS5BlmaLoAh9+6wuzwYsYot+qJG7G8WYPiJaiGdAip2i4YXb9DkPJSbTpc61vlw8dRnuLNG+G488FS9dbRL4iTeKVq90YTxJoQL8sl9SPE+o8x0B+AiK5xC3w5eUMd8b2g= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org AC7E7414373B Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.a=rsa-sha256 header.s=20230601 header.b=dNMA1zvj Received: by mail-ot1-f65.google.com with SMTP id 46e09a7af769-7c71cca8fc2so2558402a34.1 for ; Sat, 06 Dec 2025 16:10:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1765066247; x=1765671047; darn=gcc.gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=DoXlcRyqZN/lvPXQeRpHl70WzCeYSJDy+MfPNUjbl+c=; b=dNMA1zvjuPtM5xoNmxJVOh2cmcV2u6Gb48Sjx6X9qMINZCje3XgPPzSzI2VbFSNciJ SjR7BY+Y5dQ+5QhQf5SzlGC7aQp8TCdXpsRG88UFMAeX2ZWuUnKq9s6YTUWkfkgudXkm 9jXJ7Kppo9v5aZAh2gzyOb7ZJqt5+eL5Mg2zjpvmCV4i0IofU8IOoGE7xJ0tYS/NywyZ yZRM2/0miZNVD/VBcEW9UHf4L2Gz6OY7uhCCkS6oP2R8KBKJakfH5d+BZ3zqWakpmtic cO1P4znpt27jrRufJwnUbyZ2yRKDfpWu38ntQ+6VPlx+TCRcmFM7ctPyfU/hpjxN+NjW e5rQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765066247; x=1765671047; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=DoXlcRyqZN/lvPXQeRpHl70WzCeYSJDy+MfPNUjbl+c=; b=Sm1smmF+Ek4uAw/R46sZqrerVqkt4+ODJ6hkHhreLXs1vy3d4biciz4gD33dAdfR37 8SGD6WcQNVeS6TGM1jxuzoxKw+hTcmOgvQEfSnPYzw/Z1i04NHL3WWZYgLers/oHOobF Vw+50EmimXWolcb6oxp8gdxNbF9MOV/joFAIDfq73GhwSlnL04vjoXkSys/d9tBRrqaZ hc1O2u5mwdqo8ZdSVU+fQaSJUXDljWYohwjfudoa7bVIDKeGNqTxF/y6Z1kXgh8JRNEX A7iANuxH2CXj+hmIC4XDKze6UAooAKX4V444y4mAg+ULht4WkjJTJPOsDsZWLqDOLS2f GarQ== X-Gm-Message-State: AOJu0Yw6ZCFosgCdbgPb+DecfqmRr/SYDmAuWnoVSIofjQl+gudbVc4b 4nzRx6oC9o87bnZUe83Ez/hwf9d2XhznWgJHBVmVCWimbplvu4s16AG4teS8LJFnam0eM5QMP5x VDkkwxsg= X-Gm-Gg: ASbGncv8HEUZ5zq1n8Yer+8NMoCQ8X4zglMTKo0f6q7TWxIQdZrMINGdx5ZpEMmgs1O eSVfTEdMD6DUOIDuM6I9uGbszTAl2sC9llgO1bPQicibCfh1Y4OAsv+eLMVxF3QP+7r7noECV12 VskHoM+zaOJ76DaP5gzx/EvwiJl2j8AGm/hQcyvg+I9sojc+EWBFdpIM8GKE5GvfKeCDnLgXgwZ VyTOfhth5VD7jQhu1QU6IMKtloacL/iddfyDRMCINXEM7eKn/HaUvnB8T4us1gsqg4hKYmPjyoZ intph+EHtvLh9R0QP6R+dv9mNDGkiqdQXM0QvMIKgqrBIfBTcJ4qlaB/hlojtffgVW/ALc2Bo+a 23CqPR+Sm2mnzyAp0mp89BI5vVLnTpAy+vH3ATz6g3Qlr9RHTyAJUSJSgqSih+V9XHnKCL6TlyJ dMKbp8LeXvljd8 X-Google-Smtp-Source: AGHT+IGAz80LrYsBmd5R0cT4AV1gsKHEmcJ2lxpAMESbt55HWYoNCCuiRs2TwSO9tgMUnur6kU/O2A== X-Received: by 2002:a05:6830:30a2:b0:7c7:66f7:2caf with SMTP id 46e09a7af769-7c97078640dmr1583113a34.10.1765066247047; Sat, 06 Dec 2025 16:10:47 -0800 (PST) Received: from localhost.localdomain ([2601:281:d901:97c0::6b05]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7c95a8f8d0bsm7598391a34.5.2025.12.06.16.10.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Dec 2025 16:10:46 -0800 (PST) From: Sandra Loosemore To: gcc-patches@gcc.gnu.org Subject: [PATCH 04/20] doc, ia64: Clean up documentation of IA-64 options [PR122243] Date: Sat, 6 Dec 2025 17:10:14 -0700 Message-Id: <20251207001030.1024365-5-sloosemore@baylibre.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20251207001030.1024365-1-sloosemore@baylibre.com> References: <20251207001030.1024365-1-sloosemore@baylibre.com> MIME-Version: 1.0 X-Spam-Status: No, score=-11.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, GIT_PATCH_0, RCVD_IN_DNSWL_BLOCKED, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on 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~patchwork=sourceware.org@gcc.gnu.org This backend is no longer maintained and was supposed to have been deleted as of GCC 15, but since it is still part of GCC and documented in the manual, I have gone ahead and fixed up its options documentation for consistency with other active targets. gcc/ChangeLog PR other/122243 * config/ia64/ia64.opt (msched-prefer-data-spec-insns): Mark as explicitly "Undocumented". (msched-prefer-non-control-spec-insns): Likewise. * doc/invoke.texi (Option Summary) : Remove explicitly undocumented and redundant mno- forms from the list. (IA-64 Options): Remove documentation for already-deleted option -mfused-add and the two explicitly undocumented options. Add @opindex for negative forms and explicitly list the -mno-forms of options that are enabled by default. --- gcc/config/ia64/ia64.opt | 4 ++-- gcc/doc/invoke.texi | 44 ++++++++++++++-------------------------- 2 files changed, 17 insertions(+), 31 deletions(-) diff --git a/gcc/config/ia64/ia64.opt b/gcc/config/ia64/ia64.opt index 1d34f1092bd..3a0a1938a18 100644 --- a/gcc/config/ia64/ia64.opt +++ b/gcc/config/ia64/ia64.opt @@ -164,10 +164,10 @@ Target Var(mflag_sched_spec_control_ldc) Init(0) Use simple data speculation check for control speculation. msched-prefer-non-data-spec-insns -Target WarnRemoved +Target WarnRemoved Undocumented msched-prefer-non-control-spec-insns -Target WarnRemoved +Target WarnRemoved Undocumented msched-count-spec-in-critical-path Target Var(mflag_sched_count_spec_in_critical_path) Init(0) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 4439683cbd5..c08d84d9bdc 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -1126,8 +1126,8 @@ Objective-C and Objective-C++ Dialects}. @emph{IA-64 Options} (@ref{IA-64 Options}) @gccoptlist{-mbig-endian -mlittle-endian -mgnu-as -mgnu-ld -mno-pic --mvolatile-asm-stop -mregister-names -msdata -mno-sdata --mconstant-gp -mauto-pic -mfused-madd +-mvolatile-asm-stop -mregister-names -msdata +-mconstant-gp -mauto-pic -minline-float-divide-min-latency -minline-float-divide-max-throughput -mno-inline-float-divide @@ -1142,7 +1142,6 @@ Objective-C and Objective-C++ Dialects}. -msched-br-data-spec -msched-ar-data-spec -msched-control-spec -msched-br-in-data-spec -msched-ar-in-data-spec -msched-in-control-spec -msched-spec-ldc -msched-spec-control-ldc --msched-prefer-non-data-spec-insns -msched-prefer-non-control-spec-insns -msched-stop-bits-after-every-cycle -msched-count-spec-in-critical-path -msel-sched-dont-check-control-spec -msched-fp-mem-deps-zero-cost -msched-max-memory-insns-hard-limit -msched-max-memory-insns=@var{max-insns}} @@ -28429,13 +28428,6 @@ using the maximum throughput algorithm. @item -mno-inline-sqrt Do not generate inline code for @code{sqrt}. -@opindex mfused-madd -@opindex mno-fused-madd -@item -mfused-madd -@itemx -mno-fused-madd -Do (don't) generate code that uses the fused multiply/add or multiply/subtract -instructions. The default is to use these instructions. - @opindex mno-dwarf2-asm @opindex mdwarf2-asm @item -mno-dwarf2-asm @@ -28534,24 +28526,6 @@ are dependent on the control speculative loads. This is effective only with @option{-msched-control-spec} enabled. The default setting is enabled. -@opindex mno-sched-prefer-non-data-spec-insns -@opindex msched-prefer-non-data-spec-insns -@item -mno-sched-prefer-non-data-spec-insns -@itemx -msched-prefer-non-data-spec-insns -If enabled, data-speculative instructions are chosen for schedule -only if there are no other choices at the moment. This makes -the use of the data speculation much more conservative. -The default setting is disabled. - -@opindex mno-sched-prefer-non-control-spec-insns -@opindex msched-prefer-non-control-spec-insns -@item -mno-sched-prefer-non-control-spec-insns -@itemx -msched-prefer-non-control-spec-insns -If enabled, control-speculative instructions are chosen for schedule -only if there are no other choices at the moment. This makes -the use of the control speculation much more conservative. -The default setting is disabled. - @opindex mno-sched-count-spec-in-critical-path @opindex msched-count-spec-in-critical-path @item -mno-sched-count-spec-in-critical-path @@ -28562,26 +28536,36 @@ speculation a bit more conservative. The default setting is disabled. @opindex msched-spec-ldc +@opindex mno-sched-spec-ldc @item -msched-spec-ldc +@itemx -mno-sched-spec-ldc Use a simple data speculation check. This option is on by default. -@opindex msched-spec-ldc +@opindex msched-spec-control-ldc +@opindex mno-sched-spec-control-ldc @item -msched-control-spec-ldc +@itemx -mno-sched-control-spec-ldc Use a simple check for control speculation. This option is on by default. @opindex msched-stop-bits-after-every-cycle +@opindex mno-sched-stop-bits-after-every-cycle @item -msched-stop-bits-after-every-cycle +@itemx -mno-sched-stop-bits-after-every-cycle Place a stop bit after every cycle when scheduling. This option is on by default. @opindex msched-fp-mem-deps-zero-cost +@opindex mno-sched-fp-mem-deps-zero-cost @item -msched-fp-mem-deps-zero-cost +@itemx -mno-sched-fp-mem-deps-zero-cost Assume that floating-point stores and loads are not likely to cause a conflict when placed into the same instruction group. This option is disabled by default. @opindex msel-sched-dont-check-control-spec +@opindex mno-sel-sched-dont-check-control-spec @item -msel-sched-dont-check-control-spec +@itemx -mno-sel-sched-dont-check-control-spec Generate checks for control speculation in selective scheduling. This flag is disabled by default. @@ -28593,7 +28577,9 @@ instruction group. Frequently useful to prevent cache bank conflicts. The default value is 1. @opindex msched-max-memory-insns-hard-limit +@opindex mno-sched-max-memory-insns-hard-limit @item -msched-max-memory-insns-hard-limit +@itemx -mno-sched-max-memory-insns-hard-limit Makes the limit specified by @option{msched-max-memory-insns} a hard limit, disallowing more than that number in an instruction group. Otherwise, the limit is ``soft'', meaning that non-memory operations