]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
doc, or1k: Clean up OpenRISC option documentation [PR122243]
authorSandra Loosemore <sloosemore@baylibre.com>
Fri, 5 Dec 2025 17:07:31 +0000 (17:07 +0000)
committerSandra Loosemore <sloosemore@baylibre.com>
Sat, 13 Dec 2025 04:13:47 +0000 (04:13 +0000)
I'm not sure what the rationale is for having "RejectNegative" on all
of the options that control instruction usage except for -mdouble-float,
but with this patch the documentation matches what is in the .opt files.

gcc/ChangeLog
PR other/122243
* config/or1k/elf.opt (mnewlib): Mark obsolete option as
"Undocumented".
* config/or1k/or1k.opt (mcmov): Don't use future tense in doc string.
(msfimm): Likewise.
(mshftimm): Likewise.
* doc/invoke.texi (Option Summary) <OpenRISC Options>: Don't
document -mnewlib.
(OpenRISC Options): Likewise.  Add @opindex entry for
-mno-double-float.  Fix more instances of incorrect use of future
tense.

gcc/config/or1k/elf.opt
gcc/config/or1k/or1k.opt
gcc/doc/invoke.texi

index 28e960ed2081b217194dd347eb65658b539bd267..578aba3ba04c298ee08dcf812df4a70636f8458c 100644 (file)
@@ -28,6 +28,6 @@ Target RejectNegative Joined
 Configure the newlib board specific runtime.  The default is or1ksim.
 
 mnewlib
-Target RejectNegative
+Target RejectNegative Undocumented
 This option is ignored; it is provided for compatibility purposes only.  This
 used to select linker and preprocessor options for use with newlib.
index d252de082041c531286e27fbea946e1d20e75d39..9ce8b800ed59d6e6336bc32522d81b9123dcbf27 100644 (file)
@@ -85,7 +85,7 @@ Enum(or1k_cmodel_type) String(large) Value(CMODEL_LARGE)
 mcmov
 Target RejectNegative Mask(CMOV)
 Enable generation of conditional move (l.cmov) instructions.  By default the
-equivalent will be generated using set and branch.
+equivalents are generated using set and branch.
 
 mror
 Target RejectNegative Mask(ROR)
@@ -106,11 +106,11 @@ loads are used to perform sign extension.
 msfimm
 Target RejectNegative Mask(SFIMM)
 Enable generation of compare and set flag with immediate (l.sf*i) instructions.
-By default extra instructions will be generated to store the immediate to a
+By default extra instructions are generated to store the immediate to a
 register first.
 
 mshftimm
 Target RejectNegative Mask(SHFTIMM)
 Enable generation of shift with immediate (l.srai, l.srli, l.slli) instructions.
-By default extra instructions will be generated to store the immediate to a
+By default extra instructions are generated to store the immediate to a
 register first.
index c2283d634e153f6771c086399fedcd535e34cd27..ca200839618026808e1b841e0b6263c546e5cce1 100644 (file)
@@ -1285,7 +1285,7 @@ Objective-C and Objective-C++ Dialects}.
 -mmainkernel  -moptimize  -msoft-stack  -muniform-simt  -mgomp}
 
 @emph{OpenRISC Options} (@ref{OpenRISC Options})
-@gccoptlist{-mboard=@var{name}  -mnewlib  -mhard-mul  -mhard-div
+@gccoptlist{-mboard=@var{name}  -mhard-mul  -mhard-div
 -msoft-mul  -msoft-div
 -msoft-float  -mhard-float  -mdouble-float -munordered-float
 -mcmov  -mror  -mrori  -msext  -msfimm  -mshftimm
@@ -31615,14 +31615,9 @@ These options are defined for OpenRISC:
 
 @opindex mboard
 @item -mboard=@var{name}
-Configure a board specific runtime.  This will be passed to the linker for
+Configure a board specific runtime.  This is passed to the linker for
 newlib board library linking.  The default is @code{or1ksim}.
 
-@opindex mnewlib
-@item -mnewlib
-This option is ignored; it is for compatibility purposes only.  This used to
-select linker and preprocessor options for use with newlib.
-
 @opindex msoft-div
 @opindex mhard-div
 @item -msoft-div
@@ -31645,6 +31640,7 @@ Select software or hardware for floating point operations.
 The default is software.
 
 @opindex mdouble-float
+@opindex mno-double-float
 @item -mdouble-float
 When @option{-mhard-float} is selected, enables generation of double-precision
 floating point instructions.  By default functions from @file{libgcc} are used
@@ -31660,7 +31656,7 @@ compare and set flag operations.
 @opindex mcmov
 @item -mcmov
 Enable generation of conditional move (@code{l.cmov}) instructions.  By
-default the equivalent will be generated using set and branch.
+default the equivalents are generated using set and branch.
 
 @opindex mror
 @item -mror
@@ -31681,13 +31677,13 @@ memory loads are used to perform sign extension.
 @opindex msfimm
 @item -msfimm
 Enable generation of compare and set flag with immediate (@code{l.sf*i})
-instructions.  By default extra instructions will be generated to store the
+instructions.  By default extra instructions are generated to store the
 immediate to a register first.
 
 @opindex mshftimm
 @item -mshftimm
 Enable generation of shift with immediate (@code{l.srai}, @code{l.srli},
-@code{l.slli}) instructions.  By default extra instructions will be generated
+@code{l.slli}) instructions.  By default extra instructions are generated
 to store the immediate to a register first.
 
 @opindex mcmodel=