{"id":2219851,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2219851/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/patch/20260404234813.676699-1-sloosemore@baylibre.com/","project":{"id":17,"url":"http://patchwork.ozlabs.org/api/1.2/projects/17/?format=json","name":"GNU Compiler Collection","link_name":"gcc","list_id":"gcc-patches.gcc.gnu.org","list_email":"gcc-patches@gcc.gnu.org","web_url":null,"scm_url":null,"webscm_url":null,"list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260404234813.676699-1-sloosemore@baylibre.com>","list_archive_url":null,"date":"2026-04-04T23:48:11","name":"[PUSHED,1/3] doc: Rename \"Submodel Options\"","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"7d6e7beab278248fa839d05a6b04eac75e5cdc39","submitter":{"id":87955,"url":"http://patchwork.ozlabs.org/api/1.2/people/87955/?format=json","name":"Sandra Loosemore","email":"sloosemore@baylibre.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/gcc/patch/20260404234813.676699-1-sloosemore@baylibre.com/mbox/","series":[{"id":498754,"url":"http://patchwork.ozlabs.org/api/1.2/series/498754/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/list/?series=498754","date":"2026-04-04T23:48:11","name":"[PUSHED,1/3] doc: Rename \"Submodel Options\"","version":1,"mbox":"http://patchwork.ozlabs.org/series/498754/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2219851/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2219851/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":["incoming@patchwork.ozlabs.org","gcc-patches@gcc.gnu.org"],"Delivered-To":["patchwork-incoming@legolas.ozlabs.org","gcc-patches@gcc.gnu.org"],"Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=UuvcGOTU;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org\n (client-ip=38.145.34.32; helo=vm01.sourceware.org;\n envelope-from=gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org;\n receiver=patchwork.ozlabs.org)","sourceware.org;\n\tdkim=pass (2048-bit key,\n unprotected) header.d=baylibre-com.20251104.gappssmtp.com\n header.i=@baylibre-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=UuvcGOTU","sourceware.org;\n dmarc=none (p=none dis=none) header.from=baylibre.com","sourceware.org; spf=pass smtp.mailfrom=baylibre.com","server2.sourceware.org;\n arc=none smtp.remote-ip=209.85.210.46"],"Received":["from vm01.sourceware.org (vm01.sourceware.org [38.145.34.32])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fpC3p3t3Cz1y2d\n\tfor ; Sun, 05 Apr 2026 09:49:08 +1000 (AEST)","from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id F41694BA23EC\n\tfor ; Sat, 4 Apr 2026 23:49:06 +0000 (GMT)","from mail-ot1-f46.google.com (mail-ot1-f46.google.com\n [209.85.210.46])\n by sourceware.org (Postfix) with ESMTPS id ED81F4BA2E28\n for ; Sat, 4 Apr 2026 23:48:22 +0000 (GMT)","by mail-ot1-f46.google.com with SMTP id\n 46e09a7af769-7d7e9b97a73so2420268a34.0\n for ; Sat, 04 Apr 2026 16:48:22 -0700 (PDT)","from nenufar.hsd1.co.comcast.net ([2601:281:d901:97c0::9a27])\n by smtp.gmail.com with ESMTPSA id\n 006d021491bc7-680a63c7fd1sm6100242eaf.8.2026.04.04.16.48.20\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Sat, 04 Apr 2026 16:48:21 -0700 (PDT)"],"DKIM-Filter":["OpenDKIM Filter v2.11.0 sourceware.org F41694BA23EC","OpenDKIM Filter v2.11.0 sourceware.org ED81F4BA2E28"],"DMARC-Filter":"OpenDMARC Filter v1.4.2 sourceware.org ED81F4BA2E28","ARC-Filter":"OpenARC Filter v1.0.0 sourceware.org ED81F4BA2E28","ARC-Seal":"i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775346503; cv=none;\n b=k9H1VVQVZCLVsoX7dJbg5Ed0TNgrwokJL4n+ipmRtgXndSdEc2ISEAM8qRRe+XLR0y9Vwn4+NtCuBwcS3nQXHnNHtjzC7OGpdfQr0u0U3qy88bpiVLPam/KZMbCBrju1Y+qiBKuI0hHmmha16b5+p/zzxRtvn3X6OwnfKzWmwXQ=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775346503; c=relaxed/simple;\n bh=RFTP7YgDUYN8SBLtduyhQljhVFhyjz12RLEHMw9L/wk=;\n h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version;\n b=ULSBL+ZPWXvqDLmYme12GAGo5v5mMbtmcqpZooGzUE76lRBk/Kz2j6wZ8/xxb1/qhmrsW+QIIWxO58MqJdUJH92pnv0NpUh4FWEe1WGQv+s4qrEz4O/CxN9c54x72tImgBbLcms4iEYJgHh7X7nIA86OpurMrbEmdw2e24Uo7ac=","ARC-Authentication-Results":"i=1; server2.sourceware.org","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=baylibre-com.20251104.gappssmtp.com; s=20251104; t=1775346502;\n x=1775951302;\n darn=gcc.gnu.org;\n h=content-transfer-encoding:mime-version:message-id:date:subject:to\n :from:from:to:cc:subject:date:message-id:reply-to;\n bh=58oTPTKekAM0Gg/mb6A2QsLcIppIPL6fI6+3EUsbqXo=;\n b=UuvcGOTUbqIQuTb+0yQgipQJ1AVSwnUd/Les+tMLC9rYkmyo+zXeVks7AL0hBD+a5O\n wEPUL6OAOLNa3OCdLKpRmG3hfwI0vuv1GcLV1Ev8JOIzCM+tR7QSny1XeG0jOSSnAQdw\n I6EnEdZyGd7Ngf0/70JjLbM4DLBlgQ5ggoe795IAGclrccyon+HTCFzf7GtptzO8IV/b\n K+G0ZNEbwMCcy23wlzCftZpiWHUa2NFxDJsDNBoPl6ClWei4EjZFe1vdlG7JqLICFv5S\n wmqb6yosQnaRuGrmZgIWBHt2g8QFjbbtXauTGi/QRzl39jtF7i/44NlbNI4AHsK47V7J\n AseQ==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1775346502; x=1775951302;\n h=content-transfer-encoding:mime-version:message-id:date:subject:to\n :from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id\n :reply-to;\n bh=58oTPTKekAM0Gg/mb6A2QsLcIppIPL6fI6+3EUsbqXo=;\n b=qNQPCFyOezMdPpvKxb5AO0xdHGvjXSihSfyedDov2kxWGUaoasjbhZXxR9X+yguGkN\n /1UId9sDyb/q87HZlqaPmtBBxGzMwCwLyWXmdcCbOo97N4RagV4m/RlOfKWVEkd4kUKR\n LQe13zMEVdk5K7X9x6fFozsShvNySG7KDBZIjfFI5vtcOwiSBN8teKNXjGymqtperNxA\n rB5qyRb0EYDiBqoAl1D+HPLt+TTPR3qlXt4vSIldyVbc6X4GrB2uSyntqC7+0Gh6XJeK\n ZqAJBeHcGO3cMvLa/Ks8lfMCL82LSoWcp+MqpXjvqdHOF5uuiO8FnhPmPQd/CPFh4k3k\n nGlA==","X-Gm-Message-State":"AOJu0Yxf+U2pUKykoyHGDb84G1kCA6XPwH0ubO6eD0pXoW041ygq35H1\n mYdmqyKKHYTtvjB13Wg2dKDt4rV3sBrA9vlMzYERFhtiwVWttxQ66ZPJzQYZS4ZNVXNCcHNSs3g\n QeFZZ","X-Gm-Gg":"AeBDieusrU1fED+XizmZfyzuPZVMK+DLfNzj9+jIT4Na1f0L8QvxWaaYkrRcY2k4yMr\n uMQN4oFbPYSZosnuJ4Nwil4y2s5Af85GI1c/9I+MmbkVaotiKv9KNRzMIab7kX+zA4wz/FXLTo7\n CWdm1HTGUDNpoPuONBOur3oirWSkp/nqZcBi/GN4sURDhm8dTfGScvuzKNCG1LbKsJ8bGXDq4Tp\n Da0AvJPpUXBN8vEKSzrFJ01HdxywPqenEbDYsNeQfJ7lr0/3mvMmVeGQfyKXkeJyS3VRFfYQ6ky\n a1g+hwhzidGOgwcIocdgmC9n7irJ6tPowistglwQiYN0ponJKvNskVJrDXyOWqJOqFngG++dWhQ\n 0l1XOyoXLauK0EgiHRg6F2Pc7G2Dx6iKGxpqDIrT7Cc36u9PyLIQpJkN7wps4iOFzqXE86KUuSH\n ZX3qLSQLd8G4gtvx3T8m9ZZ8feHu6sMrKI","X-Received":"by 2002:a05:6820:c82:b0:67e:16d8:8107 with SMTP id\n 006d021491bc7-68220b4a63cmr3909700eaf.26.1775346501781;\n Sat, 04 Apr 2026 16:48:21 -0700 (PDT)","From":"Sandra Loosemore ","To":"gcc-patches@gcc.gnu.org","Subject":"[PUSHED 1/3] doc: Rename \"Submodel Options\"","Date":"Sat, 4 Apr 2026 17:48:11 -0600","Message-Id":"<20260404234813.676699-1-sloosemore@baylibre.com>","X-Mailer":"git-send-email 2.34.1","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-BeenThere":"gcc-patches@gcc.gnu.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"Gcc-patches mailing list ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org"},"content":"The node name \"Submodel Options\" is not meaningful, and the section name\n\"Machine-Dependent Options\" is misleading since this section also contains\nsubsections documenting options for the software environment on the target\nas well as its hardware -- for example, Windows/Cygwin/MinGW, Darwin, etc.\n\"Target-Specific Options\" is a better name for it as we already use that\nphrasing elsewhere, e.g. \"Target-Specific Attributes\".\n\ngcc/ChangeLog\n\t* doc/extend.texi (Common Attributes): Fix cross-reference for\n\trenamed \"Submodel Options\" -> \"Target-Specific Options\".\n\t* doc/invoke.texi (Invoking GCC): Likewise for the menu.\n\t(Option Summary): Likewise for the use here.\n\t(Submodel Options): Rename to Target-Specific Options. Leave\n\tan anchor with the old name. Add better index entries. Rewrite\n\tintroductory text.\n\t(Precompiled Headers): Fix another cross-reference.\n---\n gcc/doc/extend.texi | 2 +-\n gcc/doc/invoke.texi | 39 +++++++++++++++++++++------------------\n 2 files changed, 22 insertions(+), 19 deletions(-)","diff":"diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi\nindex b9d8b8955a9..d7956557353 100644\n--- a/gcc/doc/extend.texi\n+++ b/gcc/doc/extend.texi\n@@ -4936,7 +4936,7 @@ command line. The original target command-line options are ignored.\n One or more strings can be provided as arguments.\n Each string consists of one or more comma-separated suffixes to\n the @code{-m} prefix jointly forming the name of a machine-dependent\n-option. @xref{Submodel Options,,Machine-Dependent Options}.\n+option. @xref{Target-Specific Options}.\n \n The @code{target} attribute can be used for instance to have a function\n compiled with a different ISA (instruction set architecture) than the\ndiff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi\nindex bcde816d2fc..aab93f49e7a 100644\n--- a/gcc/doc/invoke.texi\n+++ b/gcc/doc/invoke.texi\n@@ -169,8 +169,8 @@ listing and explanation of the binary and decimal byte size prefixes.\n and register usage.\n * Developer Options:: Printing GCC configuration info, statistics, and\n debugging dumps.\n-* Submodel Options:: Target-specific options, such as compiling for a\n- specific processor variant.\n+* Target-Specific Options:: Options specific to particular architectures or\n+ runtime environments.\n * Environment Variables:: Env vars that affect GCC.\n * Precompiled Headers:: Compiling a header once, and using it many times.\n * C++ Modules::\t\tExperimental C++20 module system.\n@@ -882,8 +882,8 @@ Objective-C and Objective-C++ Dialects}.\n --param @var{name}=@var{value}\n }\n \n-@item Machine-Dependent Options\n-@xref{Submodel Options,,Machine-Dependent Options}.\n+@item Target-Specific Options\n+@xref{Target-Specific Options}.\n @c This list is ordered alphanumerically by subsection name.\n @c Try and put the significant identifier (CPU or system) first,\n @c so users have a clue at guessing where the ones they want will be.\n@@ -21194,27 +21194,30 @@ problems or, in some cases, to provide workarounds for compiler bugs.\n for documentation of these internal parameters.\n @end table\n \n-@node Submodel Options\n-@section Machine-Dependent Options\n+@anchor{Submodel Options}\n+@node Target-Specific Options\n+@section Target-Specific Options\n @cindex submodel options\n-@cindex specifying hardware config\n-@cindex hardware models and configurations, specifying\n-@cindex target-dependent options\n-@cindex machine-dependent options\n+@cindex hardware-specific options\n+@cindex target-specific options\n+@cindex machine-specific options\n+@cindex architecture-specific options\n+@cindex operating-system-specific options\n \n Each target machine supported by GCC can have its own options---for\n example, to allow you to compile for a particular processor variant or\n-ABI, or to control optimizations specific to that machine. By\n-convention, the names of machine-specific options start with\n-@samp{-m}.\n+ABI, or to control optimizations specific to that machine. Similarly,\n+GCC also has options that are specific to particular operating systems\n+or runtime environments on the target.\n \n-Some configurations of the compiler also support additional target-specific\n-options, usually for compatibility with other compilers on the same\n-platform.\n+By convention, the names of machine-specific options start with\n+@samp{-m}. Some configurations of the compiler also support\n+additional target-specific options, usually for compatibility with\n+other compilers on the same platform.\n \n @c This list is ordered alphanumerically by subsection name.\n @c It should be the same order and spelling as these options are listed\n-@c in Machine Dependent Options\n+@c in Target-Specific Options\n \n @menu\n * AArch64 Options::\n@@ -37695,7 +37698,7 @@ a precompiled header built using @option{-g} can be used in a compilation\n when no debugging information is being output.\n \n @item The same @option{-m} options must generally be used when building\n-and using the precompiled header. @xref{Submodel Options},\n+and using the precompiled header. @xref{Target-Specific Options},\n for any cases where this rule is relaxed.\n \n @item Each of the following options must be the same when building and using\n","prefixes":["PUSHED","1/3"]}