From cca7c55cda3db8038f6e20e813ea8b17644531eb Mon Sep 17 00:00:00 2001 From: Sandra Loosemore Date: Fri, 5 Dec 2025 17:07:27 +0000 Subject: [PATCH] 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) : 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 @@ ; . */ 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 9f7298d8e8b..c84bc10eb75 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 -- 2.47.3