From patchwork Sun Dec 7 00:10:19 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 126067 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 E65214140708 for ; Sun, 7 Dec 2025 00:12:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E65214140708 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=zd4HUx2p X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-ot1-f66.google.com (mail-ot1-f66.google.com [209.85.210.66]) by sourceware.org (Postfix) with ESMTPS id 9D0BF41436C6 for ; Sun, 7 Dec 2025 00:10:56 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 9D0BF41436C6 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 9D0BF41436C6 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=209.85.210.66 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1765066256; cv=none; b=TQ1uZU9bPxpjJsqIhQ46f4rffK1fzHxNaS3kWKmNDga3dmAq6sS6hw3OLY0DHzMomvpZjNOJhCltzMYH49KofOsvPhaNz0+sy/itGxqezA2ewZdeyZ3ujW4Mvf9GmUtjvqXSs8QGiBfbzNUxplAAR/l1RNTBqG+jSVdyHx1SXi0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1765066256; c=relaxed/simple; bh=NLb7zYOfmxYGttC5tTfLEtYq7E2hNahY73wznJ7GCnI=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=SMsDRzuH9FpOUFk3dLeEoABl/+inexE4D2Rli/1HwIKOv0XbDWiEXlegfDK7yEDzY84h2kiMogsPxLdRW2VKXucXvbVwlDSn+HmjFJ9j7i74oziRZM7O/e+RJWnS9+HRGsAwy8qQKOh//26UxyR7DIZ/FqeFu/PLrcw6sy7oqFU= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9D0BF41436C6 Received: by mail-ot1-f66.google.com with SMTP id 46e09a7af769-7c77fc7c11bso3584625a34.1 for ; Sat, 06 Dec 2025 16:10:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1765066256; x=1765671056; darn=gcc.gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=0DVFXSAtE8Vjhs6yMQ49tr/pdrwoBMripCOR5JVO4aA=; b=zd4HUx2psk93B5rDXJMYNcYPmq9EY4cS6ArpkDUZHQF8n7lpsaRH13o10RziZahWiy IhCqeK/b0U+OIVQ0TrN3Iuqj3RWGGHlanQ61/152EKJiYooILvnHj6lFmo5Eswdav+4t BHT7MZhpP1GsrsqlekguNBqvo/4S+tcO2W6Pni/jPRNt2OejxYaa+lxS5kF6GLNalT1L jLuaKUhb+hMeKQ+QCcOfBf0LXQo9hWCJoHsI5XTBzgZSQrcVX2idWQuPzuUkrystePw7 EwAbXXDbaeDukJiia2BhJw/k+xs6oI+geXvpBJVPP7TkVAa3DLm4Gg7LpzMvEspnzgMB joZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765066256; x=1765671056; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=0DVFXSAtE8Vjhs6yMQ49tr/pdrwoBMripCOR5JVO4aA=; b=HshaA2mVfzKmJVnaPB2rsQW6Ua0dKFEB0xQswFhOI9kdLMx92ndwtHfWkd1uYUVVvv uh1VSnBE3G/4ZipLHul6o1BjiCPtGsOuGIFz09avbpDAv34G+iyz+P7Oz+s5PwE/iINi 9WNHUaTu/nHck9FIdrpeFS9JZ8+Wl4zX1MlBtn2wod6auF04endemggKN44xnvqPoEHx EK22p07DZfxa6bUxUoYPqm1g9VxqCFPGjtl0JWcScCDmDCDzXVHCzRzrdINhi6jhF1Yk dTVHuN0pXZK+zCdQ4nR3tFy2DTsbtdmLz3Ba8Zkln1Yd8fH7kHoWr/v+rWSWbj7xv8nx rj/g== X-Gm-Message-State: AOJu0YzmkfqOF/XrADOKoRASXoyUV7kdcdUKoY97Ko/ZBNgTkZ0kJbgz WVYyGsae3O/v9MG4C8eFLv7Umc42IBDc8lWUxbI+n/tBeqeqfCd/CrMCoiniCJzkfCT1G7Py9CV jzurzrFw= X-Gm-Gg: ASbGncsYrC41NpzXRUd/ChQNdib7TgPvcWlueoKl1OjCo2Btg78leawslBkAP4y8rHa 9hhKiWjwJ+foGloXNOuJYcVcsOzxgZdhd79njGXU9iIKPoT/mjx/4NhuCQT2aHfzQSp8ntDFajh /NdtHotD4OVC/u/RevRk0e+VxiUIH+K3Fygylg2p12CKcHnwahXWsKUqWuXq82IFAjc54eALrTG i0fMtCXsw/GQ7BfFHRrLuWRqgBSi8tBfW+eh6UDpOsJvJnwsFXWN3Z1UZRIxcCECJ1nM+bGAuSM mQR5jHeCw0I9wolnscnp+Sdpx6+IGsYaq+x50H6ENwmEnkR4jkoop7LLB/INRwGKfOSIRNNd7w7 /vI78fORIKRvunQMU/U1EQoQKfJktBe6ltNh+ASs2qOe96TbZEZx/qznDtXwtlhgkUlwHKIMbj2 rVpSzZzQYquhDE X-Google-Smtp-Source: AGHT+IHAQLpw1pL1qHP2G5gDX97s2zzNoHVYgQUJNOzo/2YQGO1WRe1eMIvOpiH5jfoyWPotYEy1Ow== X-Received: by 2002:a05:6830:338d:b0:7c7:5064:acac with SMTP id 46e09a7af769-7c957bd6c37mr5833678a34.4.1765066255960; Sat, 06 Dec 2025 16:10:55 -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.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Dec 2025 16:10:55 -0800 (PST) From: Sandra Loosemore To: gcc-patches@gcc.gnu.org Cc: jeffreyalaw@gmail.com, schwab@linux-m68k.org Subject: [PATCH 09/20] doc, m68k: Clean up M680x0 option documentation [PR122243] [PR119404] Date: Sat, 6 Dec 2025 17:10:19 -0700 Message-Id: <20251207001030.1024365-10-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_NONE, 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 gcc/ChangeLog PR other/122243 PR target/119404 * config/m68k/m68k.opt (mlra): Fix typo in help string. * doc/invoke.texi (Option Summary) : Remove redundant -mno- forms from the list. (M680x0 Options): Combine documentation for -mshort, mbitfield, -msep-data, -mid-shared-library with that for their respective negatives that were formerly separately listed. Add missing @opindex entries. --- gcc/config/m68k/m68k.opt | 2 +- gcc/doc/invoke.texi | 65 +++++++++++++++++++++------------------- 2 files changed, 36 insertions(+), 31 deletions(-) diff --git a/gcc/config/m68k/m68k.opt b/gcc/config/m68k/m68k.opt index 35f86ba11ff..afd1b494eef 100644 --- a/gcc/config/m68k/m68k.opt +++ b/gcc/config/m68k/m68k.opt @@ -148,7 +148,7 @@ Use 32-bit offsets in jump tables rather than 16-bit offsets. mlra Target Var(m68k_lra_p) Undocumented -Usa LRA for reload instead of the old reload framework. This option is +Use LRA for reload instead of the old reload framework. This option is experimental, and it may be removed in future versions of the compiler. mnobitfield diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 2ce6462c66d..d5c8b411474 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -1186,12 +1186,12 @@ Objective-C and Objective-C++ Dialects}. @gccoptlist{-march=@var{arch} -mcpu=@var{cpu} -mtune=@var{tune} -m68000 -m68020 -m68020-40 -m68020-60 -m68030 -m68040 -m68060 -mcpu32 -m5200 -m5206e -m528x -m5307 -m5407 --mcfv4e -mbitfield -mno-bitfield -mc68000 -mc68020 --mnobitfield -mrtd -mno-rtd -mdiv -mno-div -mshort --mno-short -mhard-float -m68881 -msoft-float -mpcrel --malign-int -mstrict-align -msep-data -mno-sep-data --mshared-library-id=n -mid-shared-library -mno-id-shared-library --mxgot -mno-xgot -mlong-jump-table-offsets} +-mcfv4e -mbitfield -mc68000 -mc68020 +-mrtd -mdiv -mshort +-mhard-float -m68881 -msoft-float -mpcrel +-malign-int -mstrict-align -msep-data +-mshared-library-id=@var{n} -mid-shared-library +-mxgot -mlong-jump-table-offsets} @emph{MCore Options} (@ref{MCore Options}) @gccoptlist{-mhardlit -mno-hardlit -mdiv -mno-div -mrelax-immediates @@ -29457,31 +29457,30 @@ example, the default is ``off'' for @option{-mcpu=5206} and ``on'' for GCC defines the macro @code{__mcfhwdiv__} when this option is enabled. @opindex mshort +@opindex mno-short @item -mshort +@itemx -mno-short Consider type @code{int} to be 16 bits wide, like @code{short int}. Additionally, parameters passed on the stack are also aligned to a 16-bit boundary even on targets whose API mandates promotion to 32-bit. - -@opindex mno-short -@item -mno-short -Do not consider type @code{int} to be 16 bits wide. This is the default. - -@opindex mnobitfield -@opindex mno-bitfield -@item -mnobitfield -@itemx -mno-bitfield -Do not use the bit-field instructions. The @option{-m68000}, @option{-mcpu32} -and @option{-m5200} options imply @w{@option{-mnobitfield}}. +This option is disabled by default. @opindex mbitfield +@opindex mno-bitfield +@opindex mnobitfield @item -mbitfield -Do use the bit-field instructions. The @option{-m68020} option implies -@option{-mbitfield}. This is the default if you use a configuration -designed for a 68020. +@itemx -mno-bitfield +@itemx -mnobitfield +Control use of the bit-field instructions. +The @option{-m68000}, @option{-mcpu32} +and @option{-m5200} options imply @w{@option{-mnobitfield}}; +the @option{-m68020} option implies @option{-mbitfield}. @opindex mrtd +@opindex mno-rtd @item -mrtd -Use a different function-calling convention, in which functions +@itemx -mno-rtd +Control use of a different function-calling convention, in which functions that take a fixed number of arguments return with the @code{rtd} instruction, which pops their arguments while returning. This saves one instruction in the caller since there is no need to pop @@ -29533,26 +29532,32 @@ not presently supported with @option{-mpcrel}, though this could be supported fo Do not (do) assume that unaligned memory references are handled by the system. +@opindex msep-data +@opindex mno-sep-data @item -msep-data -Generate code that allows the data segment to be located in a different +@itemx -mno-sep-data +With @option{-msep-data}, +generate code that allows the data segment to be located in a different area of memory from the text segment. This allows for execute-in-place in an environment without virtual memory management. This option implies @option{-fPIC}. -@item -mno-sep-data -Generate code that assumes that the data segment follows the text segment. -This is the default. +This option is disabled by default; GCC +generates code that assumes that the data segment follows the text segment. +@opindex mid-shared-library +@opindex mno-id-shared-libary @item -mid-shared-library -Generate code that supports shared libraries via the library ID method. +@itemx -mno-id-shared-library +If enabled, generate code that supports shared libraries via the +library ID method. This allows for execute-in-place and shared libraries in an environment without virtual memory management. This option implies @option{-fPIC}. -@item -mno-id-shared-library -Generate code that doesn't assume ID-based shared libraries are being used. -This is the default. +This option is disabled by default. -@item -mshared-library-id=n +@opindex mshared-library-id +@item -mshared-library-id=@var{n} Specifies the identification number of the ID-based shared library being compiled. Specifying a value of 0 generates more compact code; specifying other values forces the allocation of that number to the current