https://gcc.gnu.org/g:222189a85c51c767ccec8399ddd025d922a7e95f
commit r16-8468-g222189a85c51c767ccec8399ddd025d922a7e95f Author: Sandra Loosemore <[email protected]> Date: Sat Apr 4 22:10:52 2026 +0000 doc: Rename "Submodel Options" The node name "Submodel Options" is not meaningful, and the section name "Machine-Dependent Options" is misleading since this section also contains subsections documenting options for the software environment on the target as well as its hardware -- for example, Windows/Cygwin/MinGW, Darwin, etc. "Target-Specific Options" is a better name for it as we already use that phrasing elsewhere, e.g. "Target-Specific Attributes". gcc/ChangeLog * doc/extend.texi (Common Attributes): Fix cross-reference for renamed "Submodel Options" -> "Target-Specific Options". * doc/invoke.texi (Invoking GCC): Likewise for the menu. (Option Summary): Likewise for the use here. (Submodel Options): Rename to Target-Specific Options. Leave an anchor with the old name. Add better index entries. Rewrite introductory text. (Precompiled Headers): Fix another cross-reference. Diff: --- gcc/doc/extend.texi | 2 +- gcc/doc/invoke.texi | 39 +++++++++++++++++++++------------------ 2 files changed, 22 insertions(+), 19 deletions(-) diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index b9d8b8955a9a..d7956557353a 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -4936,7 +4936,7 @@ command line. The original target command-line options are ignored. One or more strings can be provided as arguments. Each string consists of one or more comma-separated suffixes to the @code{-m} prefix jointly forming the name of a machine-dependent -option. @xref{Submodel Options,,Machine-Dependent Options}. +option. @xref{Target-Specific Options}. The @code{target} attribute can be used for instance to have a function compiled with a different ISA (instruction set architecture) than the diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index bcde816d2fca..aab93f49e7a9 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -169,8 +169,8 @@ listing and explanation of the binary and decimal byte size prefixes. and register usage. * Developer Options:: Printing GCC configuration info, statistics, and debugging dumps. -* Submodel Options:: Target-specific options, such as compiling for a - specific processor variant. +* Target-Specific Options:: Options specific to particular architectures or + runtime environments. * Environment Variables:: Env vars that affect GCC. * Precompiled Headers:: Compiling a header once, and using it many times. * C++ Modules:: Experimental C++20 module system. @@ -882,8 +882,8 @@ Objective-C and Objective-C++ Dialects}. --param @var{name}=@var{value} } -@item Machine-Dependent Options -@xref{Submodel Options,,Machine-Dependent Options}. +@item Target-Specific Options +@xref{Target-Specific Options}. @c This list is ordered alphanumerically by subsection name. @c Try and put the significant identifier (CPU or system) first, @c so users have a clue at guessing where the ones they want will be. @@ -21194,27 +21194,30 @@ problems or, in some cases, to provide workarounds for compiler bugs. for documentation of these internal parameters. @end table -@node Submodel Options -@section Machine-Dependent Options +@anchor{Submodel Options} +@node Target-Specific Options +@section Target-Specific Options @cindex submodel options -@cindex specifying hardware config -@cindex hardware models and configurations, specifying -@cindex target-dependent options -@cindex machine-dependent options +@cindex hardware-specific options +@cindex target-specific options +@cindex machine-specific options +@cindex architecture-specific options +@cindex operating-system-specific options Each target machine supported by GCC can have its own options---for example, to allow you to compile for a particular processor variant or -ABI, or to control optimizations specific to that machine. By -convention, the names of machine-specific options start with -@samp{-m}. +ABI, or to control optimizations specific to that machine. Similarly, +GCC also has options that are specific to particular operating systems +or runtime environments on the target. -Some configurations of the compiler also support additional target-specific -options, usually for compatibility with other compilers on the same -platform. +By convention, the names of machine-specific options start with +@samp{-m}. Some configurations of the compiler also support +additional target-specific options, usually for compatibility with +other compilers on the same platform. @c This list is ordered alphanumerically by subsection name. @c It should be the same order and spelling as these options are listed -@c in Machine Dependent Options +@c in Target-Specific Options @menu * AArch64 Options:: @@ -37695,7 +37698,7 @@ a precompiled header built using @option{-g} can be used in a compilation when no debugging information is being output. @item The same @option{-m} options must generally be used when building -and using the precompiled header. @xref{Submodel Options}, +and using the precompiled header. @xref{Target-Specific Options}, for any cases where this rule is relaxed. @item Each of the following options must be the same when building and using
