[gcc r16-6089] doc, microblaze: Clean up MicroBlaze option documentation [PR122243]
Sandra Loosemore
sandra@gcc.gnu.org
Sat Dec 13 04:17:52 GMT 2025
https://gcc.gnu.org/g:cca7c55cda3db8038f6e20e813ea8b17644531eb
commit r16-6089-gcca7c55cda3db8038f6e20e813ea8b17644531eb
Author: Sandra Loosemore <sloosemore@baylibre.com>
Date: Fri Dec 5 17:07:27 2025 +0000
doc, microblaze: Clean up MicroBlaze option documentation [PR122243]
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.
Diff:
---
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 639557721fb0..8a2aa6ea4119 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 9f7298d8e8b3..c84bc10eb755 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}
@@ -29728,13 +29728,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.
@@ -29744,42 +29741,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.
@@ -29795,6 +29799,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
@@ -29818,10 +29830,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
More information about the Gcc-cvs
mailing list