gcc/ChangeLog
PR other/122243
* config/microblaze/microblaze.opt (Zxl-mode-bootstrap):
Mark as "Undocumented".
(Zxl-mode-executable): Likewise.
(Zxl-mode-novectors): Likewise.
(Zxl-mode-xilkernel): Likewise.
(Zxl-mode-xmdstub): Likewise.
(mxl-stack-check): Likewise.
(mno-clearbss): Likewise.
(mxl-mode-executable): Make help string more useful.
(mxl-mode-xmdstub): Likewise.
(mxl-mode-bootstrap): Likewise.
(mxl-mode-novectors): Likewise.
(mxl-mode-xilkernel): Mark as "Undocumented".
* doc/invoke.texi (Option Summary) <MicroBlaze Options>: Delete
entries for obsolete options now explicitly undocumented, and add
missing -mxl-prefetch option.
(MicroBlaze Options): Add missing @opindex entries for negative
option forms and list negative forms explicitly when appropriate.
Delete documentation for obsolete/deprecated options. Add
missing @opindex entries for the m[no-]xml-mode- options.
Add missing documentation for -mxl-prefetch.
---
gcc/config/microblaze/microblaze.opt | 24 ++++++++--------
gcc/doc/invoke.texi | 43 +++++++++++++++++++---------
2 files changed, 41 insertions(+), 26 deletions(-)
diff --git a/gcc/config/microblaze/microblaze.opt
b/gcc/config/microblaze/microblaze.opt
index 639557721fb..8a2aa6ea411 100644
--- a/gcc/config/microblaze/microblaze.opt
+++ b/gcc/config/microblaze/microblaze.opt
@@ -21,19 +21,19 @@
; <http://www.gnu.org/licenses/>. */
Zxl-mode-bootstrap
-Driver
+Driver Undocumented
Zxl-mode-executable
-Driver
+Driver Undocumented
Zxl-mode-novectors
-Driver
+Driver Undocumented
Zxl-mode-xilkernel
-Driver
+Driver Undocumented
Zxl-mode-xmdstub
-Driver
+Driver Undocumented
msoft-float
Target RejectNegative Mask(SOFT_FLOAT)
@@ -84,7 +84,7 @@ Target Mask(PATTERN_COMPARE)
Use pattern compare instructions.
mxl-stack-check
-Target Mask(STACK_CHECK) Warn(%qs is deprecated; use -fstack-check)
+Target Mask(STACK_CHECK) Warn(%qs is deprecated; use -fstack-check)
Undocumented
Check for stack overflow at runtime.
mxl-gp-opt
@@ -92,7 +92,7 @@ Target Mask(XLGPOPT)
Use GP relative sdata/sbss sections.
mno-clearbss
-Target RejectNegative Var(flag_zero_initialized_in_bss, 0) Warn(%qs is
deprecated; use -fno-zero-initialized-in-bss)
+Target RejectNegative Var(flag_zero_initialized_in_bss, 0) Warn(%qs is
deprecated; use -fno-zero-initialized-in-bss) Undocumented
Clear the BSS to zero and place zero initialized in BSS.
mxl-multiply-high
@@ -109,19 +109,19 @@ Use hardware floating point square root instruction.
mxl-mode-executable
Target Mask(XL_MODE_EXECUTABLE)
-Description for mxl-mode-executable.
+Build application as normal executable.
mxl-mode-xmdstub
Target Mask(XL_MODE_XMDSTUB)
-Description for mxl-mode-xmdstub.
+Build application for use with xmdstub debug agent.
mxl-mode-bootstrap
Target Mask(XL_MODE_BOOTSTRAP)
-Description for mxl-mode-bootstrap.
+Build application to be loaded using a bootloader.
mxl-mode-novectors
Target Mask(XL_MODE_NOVECTORS)
-Description for mxl-mode-novectors.
+Build application without any of the MicroBlaze vectors.
mxl-prefetch
Target Mask(PREFETCH)
@@ -132,4 +132,4 @@ Target Mask(PIC_DATA_TEXT_REL)
Data referenced by offset from start of text instead of GOT (with -fPIC/-fPIE).
mxl-mode-xilkernel
-Target
+Target Undocumented
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 4ff7c2deef3..6a0c2e57ad8 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -1203,10 +1203,10 @@ Objective-C and Objective-C++ Dialects}.
@emph{MicroBlaze Options} (@ref{MicroBlaze Options})
@gccoptlist{-msoft-float -mhard-float -msmall-divides -mcpu=@var{cpu}
-mmemcpy -mxl-soft-mul -mxl-soft-div -mxl-barrel-shift
--mxl-pattern-compare -mxl-stack-check -mxl-gp-opt -mno-clearbss
+-mxl-pattern-compare -mxl-gp-opt
-mxl-multiply-high -mxl-float-convert -mxl-float-sqrt
-mbig-endian -mlittle-endian -mxl-reorder -mxl-mode-@var{app-model}
--mpic-data-is-text-relative}
+-mxl-prefetch -mpic-data-is-text-relative}
@emph{MIPS Options} (@ref{MIPS Options})
@gccoptlist{-EL -EB -march=@var{arch} -mtune=@var{arch}
@@ -29700,13 +29700,10 @@ Use software emulation for floating point (default).
Use hardware floating-point instructions.
@opindex mmemcpy
+@opindex mno-memcpy
@item -mmemcpy
Do not optimize block moves, use @code{memcpy}.
-@opindex mno-clearbss
-@item -mno-clearbss
-This option is deprecated. Use @option{-fno-zero-initialized-in-bss} instead.
-
@opindex mcpu=
@item -mcpu=@var{cpu-type}
Use features of, and schedule code for, the given CPU.
@@ -29716,42 +29713,49 @@ where @var{X} is a major version, @var{YY} is the
minor version, and
@samp{v4.00.b}, @samp{v5.00.a}, @samp{v5.00.b}, @samp{v6.00.a}.
@opindex mxl-soft-mul
+@opindex mno-xl-soft-mul
@item -mxl-soft-mul
-Use software multiply emulation (default).
+@itemx -mno-xl-soft-mul
+Use software multiply emulation. This is enabled by default.
@opindex mxl-soft-div
+@opindex mno-xl-soft-div
@item -mxl-soft-div
-Use software emulation for divides (default).
+@itemx -mno-xl-soft-div
+Use software emulation for divides. This is enabled by default.
@opindex mxl-barrel-shift
+@opindex mno-xl-barrel-shift
@item -mxl-barrel-shift
Use the hardware barrel shifter.
@opindex mxl-pattern-compare
+@opindex mno-xl-pattern-compare
@item -mxl-pattern-compare
Use pattern compare instructions.
@opindex msmall-divides
+@opindex mno-small-divides
@item -msmall-divides
Use table lookup optimization for small signed integer divisions.
-@opindex mxl-stack-check
-@item -mxl-stack-check
-This option is deprecated. Use @option{-fstack-check} instead.
-
@opindex mxl-gp-opt
+@opindex mno-xl-gp-opt
@item -mxl-gp-opt
Use GP-relative @code{.sdata}/@code{.sbss} sections.
@opindex mxl-multiply-high
+@opindex mno-xl-multiply-high
@item -mxl-multiply-high
Use multiply high instructions for high part of 32x32 multiply.
@opindex mxl-float-convert
+@opindex mno-xl-float-convert
@item -mxl-float-convert
Use hardware floating-point conversion instructions.
@opindex mxl-float-sqrt
+@opindex mno-xl-float-sqrt
@item -mxl-float-sqrt
Use hardware floating-point square root instruction.
@@ -29767,6 +29771,14 @@ Generate code for a little-endian target.
@item -mxl-reorder
Use reorder instructions (swap and byte reversed load/store).
+@opindex mxl-mode-executable
+@opindex mno-xl-mode-executable
+@opindex mxl-mode-xmdstub
+@opindex mno-xl-mode-xmdstub
+@opindex mxl-mode-bootstrap
+@opindex mno-xl-mode-bootstrap
+@opindex mxl-mode-novectors
+@opindex mno-xl-mode-novectors
@item -mxl-mode-@var{app-model}
Select application model @var{app-model}. Valid models are
@table @samp
@@ -29790,10 +29802,13 @@ MicroBlaze vectors. This option may be useful for
applications running
within a monitoring application. This model uses @file{crt3.o} as a startup
file.
@end table
-Option @option{-xl-mode-@var{app-model}} is a deprecated alias for
-@option{-mxl-mode-@var{app-model}}.
+@opindex mxl-prefetch
+@opindex mno-xl-prefetch
+@item -mxl-prefetch
+Enable insertion of prefetch (@code{wic}) instructions at call sites.
@opindex mpic-data-is-text-relative
+@opindex mno-pic-data-is-text-relative
@item -mpic-data-is-text-relative
Assume that the displacement between the text and data segments is fixed
at static link time. This allows data to be referenced by offset from start of
--
2.39.5
