diff options
author | Sandra Loosemore <sloosemore@baylibre.com> | 2025-02-11 21:52:36 +0000 |
---|---|---|
committer | Sandra Loosemore <sloosemore@baylibre.com> | 2025-02-12 01:46:18 +0000 |
commit | b9857b78a4afb7ccdb8ff3858b48d25b1df5ceb3 (patch) | |
tree | 30ca46870173d03416174b73a062b22e5e8f0b0e /gcc/doc/invoke.texi | |
parent | 29a5b1bdd9ff1bbfd2c367aea2f38fc23e6dbfb4 (diff) | |
download | gcc-b9857b78a4afb7ccdb8ff3858b48d25b1df5ceb3.zip gcc-b9857b78a4afb7ccdb8ff3858b48d25b1df5ceb3.tar.gz gcc-b9857b78a4afb7ccdb8ff3858b48d25b1df5ceb3.tar.bz2 |
Doc: Fix some typos and other nearby sloppy-writing issues
I spotted some typos in the GCC manual. Since often these are a sign
that the text was inserted without being proofread, I looked at the
context and fixed some grammar/punctuation/wording issues as well.
gcc/ChangeLog
* doc/extend.texi: Fix a bunch of typos and other writing bugs.
* doc/invoke.texi: Likewise.
Diffstat (limited to 'gcc/doc/invoke.texi')
-rw-r--r-- | gcc/doc/invoke.texi | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 56d43cb..bd42a8b 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -3014,10 +3014,10 @@ Version 17, which first appeared in G++ 12, fixes layout of classes that inherit from aggregate classes with default member initializers in C++14 and up. -Version 18, which first appeard in G++ 13, fixes manglings of lambdas +Version 18, which first appeared in G++ 13, fixes manglings of lambdas that have additional context. -Version 19, which first appeard in G++ 14, fixes manglings of structured +Version 19, which first appeared in G++ 14, fixes manglings of structured bindings to include ABI tags. Version 20, which first appeared in G++ 15, fixes manglings of lambdas @@ -10162,7 +10162,7 @@ old-style definition for older standards. @opindex Wdeprecated-non-prototype @opindex Wno-deprecated-non-prototype @item -Wdeprecated-non-prototype @r{(C and Objective-C only)} -Warn if a function declarated with an empty parameter list @samp{()} is +Warn if a function declared with an empty parameter list @samp{()} is called with one or more arguments, or if a function definition with one or more parameters is encountered after such a declaration. Both cases are errors in C23 and later dialects of C. @@ -15158,12 +15158,12 @@ This option is enabled by @option{-fauto-profile}. @opindex fprofile-partial-training @item -fprofile-partial-training With @code{-fprofile-use} all portions of programs not executed during train -run are optimized agressively for size rather than speed. In some cases it is +run are optimized aggressively for size rather than speed. In some cases it is not practical to train all possible hot paths in the program. (For example, program may contain functions specific for a given hardware and -trianing may not cover all hardware configurations program is run on.) With -@code{-fprofile-partial-training} profile feedback will be ignored for all -functions not executed during the train run leading them to be optimized as if +training may not cover all hardware configurations program is run on.) With +@code{-fprofile-partial-training} profile feedback is ignored for all +functions not executed during the train run, leading them to be optimized as if they were compiled without profile feedback. This leads to better performance when train run is not representative but also leads to significantly bigger code. @@ -15619,7 +15619,7 @@ Control whether @code{malloc} (and its variants such as @code{calloc} or @code{strdup}), can be optimized away provided its return value is only used as a parameter of @code{free} call or compared with @code{NULL}. If @option{-fmalloc-dce=1} is used, only calls to @code{free} are allowed while -with @option{-fmalloc-dce=2} also comparsions with @code{NULL} pointer are +with @option{-fmalloc-dce=2} also comparisons with @code{NULL} pointer are considered safe to remove. The default is @option{-fmalloc-dce=2}. See also @option{-fallocation-dce}. @@ -15888,12 +15888,12 @@ by the compiler are investigated. To those functions, a different be applied (@option{--param max-inline-insns-auto}). @item max-inline-insns-small -This is bound applied to calls which are considered relevant with +This is the bound applied to calls that are considered relevant with @option{-finline-small-functions}. @item max-inline-insns-size -This is bound applied to calls which are optimized for size. Small growth -may be desirable to anticipate optimization oppurtunities exposed by inlining. +This is the bound applied to calls that are optimized for size. Small growth +may be desirable to anticipate optimization opportunities exposed by inlining. @item uninlined-function-insns Number of instructions accounted by inliner for function overhead such as @@ -15928,7 +15928,7 @@ to avoid extreme compilation time caused by non-linear algorithms used by the back end. @item large-function-growth -Specifies maximal growth of large function caused by inlining in percents. +Specifies maximal growth of large functions caused by inlining in percents. For example, parameter value 100 limits large function growth to 2.0 times the original size. @@ -17276,12 +17276,12 @@ With @option{--param=openacc-privatization=noisy}, do diagnose. @item cycle-accurate-model Specifies whether GCC should assume that the scheduling description is mostly -a cycle-accurate model of the target processor, where the code is intended to +a cycle-accurate model of the target processor the code is intended to run on, in the absence of cache misses. Nonzero means that the selected scheduling model is accurate and likely describes an in-order processor, -and that scheduling will aggressively spill to try and fill any pipeline -bubbles. This is the current default. Zero could mean scheduling descrption -might not be available/accurate or perhaps not applicale at all such as for +and that scheduling should aggressively spill to try and fill any pipeline +bubbles. This is the current default. Zero means the scheduling description +might not be available/accurate or perhaps not applicable at all, such as for modern out-of-order processors. @end table @@ -17314,7 +17314,7 @@ approximation is enabled. The default value is 1. @item aarch64-double-recp-precision The number of Newton iterations for calculating the reciprocal for double type. -The precision of division is propotional to this param when division +The precision of division is proportional to this param when division approximation is enabled. The default value is 2. @item aarch64-autovec-preference @@ -20084,7 +20084,7 @@ the implementation of the @file{libatomic} runtime library. @opindex fzero-init-padding-bits=@var{value} @item -fzero-init-padding-bits=@var{value} -Guarantee zero initalization of padding bits in automatic variable +Guarantee zero initialization of padding bits in automatic variable initializers. Certain languages guarantee zero initialization of padding bits in certain cases, e.g. C23 when using empty initializers (@code{@{@}}), @@ -27646,7 +27646,7 @@ Incrementally adjust the scope of the SIMD extensions (none / LSX / LASX) that can be used by the compiler for code generation. Enabling LASX with @option{mlasx} automatically enables LSX, and diabling LSX with @option{mno-lsx} automatically disables LASX. These driver-only options act upon the final -@option{msimd} configuration state and make incremental chagnes in the order +@option{msimd} configuration state and make incremental changes in the order they appear on the GCC driver's command line, deriving the final / canonicalized @option{msimd} option that is passed to the compiler proper. @@ -29345,11 +29345,11 @@ relocation operators. This option has been superseded by @itemx -mexplicit-relocs=pcrel @itemx -mexplicit-relocs @itemx -mno-explicit-relocs -These options control whether explicit relocs (such as %gp_rel) are used. +These options control whether explicit relocs (such as @code{%gp_rel}) are used. The default value depends on the version of GAS when GCC itself was built. -The @code{base} explicit-relocs support introdunced into GAS in 2001. -The @code{pcrel} explicit-relocs support introdunced into GAS in 2014, +The @code{base} explicit-relocs support was introduced into GAS in 2001. +The @code{pcrel} explicit-relocs support was introduced into GAS in 2014, which supports @code{%pcrel_hi} and @code{%pcrel_lo}. @opindex mcheck-zero-division @@ -29671,7 +29671,7 @@ If a compact branch instruction is not available (or pre-R6), a delay slot form of the branch will be used instead. If it is used for MIPS16/microMIPS targets, it will be just ignored now. -The behaviour for MIPS16/microMIPS may change in future, +The behavior for MIPS16/microMIPS may change in future, since they do have some compact branch instructions. The @option{-mcompact-branches=optimal} option will cause a delay slot @@ -30016,27 +30016,27 @@ into GCC. However, an external @samp{devices.csv} file can be used to extend device support beyond those that have been hard-coded. GCC searches for the @samp{devices.csv} file using the following methods in the -given precedence order, where the first method takes precendence over the +given precedence order, where the first method takes precedence over the second which takes precedence over the third. @table @asis @item Include path specified with @code{-I} and @code{-L} -@samp{devices.csv} will be searched for in each of the directories specified by +@samp{devices.csv} is searched for in each of the directories specified by include paths and linker library search paths. @item Path specified by the environment variable @samp{MSP430_GCC_INCLUDE_DIR} Define the value of the global environment variable @samp{MSP430_GCC_INCLUDE_DIR} to the full path to the directory containing devices.csv, and GCC will search -this directory for devices.csv. If devices.csv is found, this directory will -also be registered as an include path, and linker library path. Header files +this directory for devices.csv. If devices.csv is found, this directory is +also registered as an include path and linker library path. Header files and linker scripts in this directory can therefore be used without manually specifying @code{-I} and @code{-L} on the command line. @item The @samp{msp430-elf@{,bare@}/include/devices} directory -Finally, GCC will examine @samp{msp430-elf@{,bare@}/include/devices} from the +Finally, GCC examines @samp{msp430-elf@{,bare@}/include/devices} from the toolchain root directory. This directory does not exist in a default installation, but if the user has created it and copied @samp{devices.csv} -there, then the MCU data will be read. As above, this directory will -also be registered as an include path, and linker library path. +there, then the MCU data is read. As above, this directory is +also registered as an include path and linker library path. @end table If none of the above search methods find @samp{devices.csv}, then the @@ -30686,7 +30686,7 @@ is to use them if the specified architecture has these instructions. @itemx -mno-fence-tso Do or don't use the @samp{fence.tso} instruction, which is unimplemented on some processors (including those from T-Head). If the @samp{fence.tso} -instruction is not availiable then a stronger fence will be used instead. +instruction is not available then a stronger fence is used instead. @opindex mdiv @item -mdiv |