This is another "extra" patch in my series to improve the organization
of invoke.texi and make it easier for users to find things.
It seemed to me that "Hardware Models and Configurations" was not an
obvious name for the section on machine-dependent options. The "Option
Summary" section already used "Machine-Dependent Options" (minus the
hyphen) to describe this group of options, so I went with that instead.
I also thought that using 30+-year-old processor names like "68010 vs
68020" as an example seemed pretty archaic, so I also rewrote the @menu
description and introductory blurb for the section to be more generic
and better reflect that nowadays target-specific options do a lot more
than just let you choose the hardware model to compile for.
I've committed this patch.
-Sandra
2016-01-13 Sandra Loosemore <san...@codesourcery.com>
gcc/
* doc/invoke.texi (Submodel Options): Rename section to
"Machine-Dependent Options" to better reflect its content.
Rewrite introductory text to remove archaic CPU names.
Update references.
Index: gcc/doc/invoke.texi
===================================================================
--- gcc/doc/invoke.texi (revision 232352)
+++ gcc/doc/invoke.texi (working copy)
@@ -148,8 +148,8 @@ only one of these two forms, whichever o
Where to find the compiler executable files.
* Code Gen Options:: Specifying conventions for function calls, data layout
and register usage.
-* Submodel Options:: Specifying minor hardware or convention variations,
- such as 68010 vs 68020.
+* Submodel Options:: Target-specific options, such as compiling for a
+ specific processor variant.
* Spec Files:: How to pass switches to sub-processes.
* Environment Variables:: Env vars that affect GCC.
* Precompiled Headers:: Compiling a header once, and using it many times.
@@ -541,8 +541,8 @@ Objective-C and Objective-C++ Dialects}.
-fvisibility=@r{[}default@r{|}internal@r{|}hidden@r{|}protected@r{]} @gol
-fstrict-volatile-bitfields -fsync-libcalls}
-@item Machine Dependent Options
-@xref{Submodel Options,,Hardware Models and Configurations}.
+@item Machine-Dependent Options
+@xref{Submodel Options,,Machine-Dependent 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.
@@ -12569,20 +12569,20 @@ the implementation of the @file{libatomi
@end table
@node Submodel Options
-@section Hardware Models and Configurations
+@section Machine-Dependent Options
@cindex submodel options
@cindex specifying hardware config
@cindex hardware models and configurations, specifying
-@cindex machine dependent options
+@cindex target-dependent options
+@cindex machine-dependent options
-Each target machine types can have its own
-special options, starting with @samp{-m}, to choose among various
-hardware models or configurations---for example, 68010 vs 68020,
-floating coprocessor or none. A single installed version of the
-compiler can compile for any model or configuration, according to the
-options specified.
+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}.
-Some configurations of the compiler also support additional special
+Some configurations of the compiler also support additional target-specific
options, usually for compatibility with other compilers on the same
platform.
