doc, cris: Clean up CRIS option documentation [PR122243]

This is another patch in the series to make documentation of
target-specific options in invoke.texi match what is in the
corresponding .opt files.

The cris.opt file is a bit strange, with many cases where negative
forms are listed explicitly as separate options from the positive
forms, with both having "RejectNegative" and one (typically the form
that is the default) being marked as "Undocumented".  I've left that
alone since fixing it to the more normal style of having a single
option setting a boolean flag would require code changes, and I'm not
set up to build or test this target.

Beyond that, the "Undocumented" status of options in the .opt file did
not in several cases match what was actually documented in the manual.
I've generally assumed that the manual is correct, and e.g. the
-m32-bit, -m16-bit, and -m8-bit options, all previously marked
"Undocumented" but listed in invoke.texi, are preferred to the
equivalent options without the hyphen.  I've removed the references to
the obsolete -melf and -maout options and added documentation in the
manual for some options that were previously documented only in the .opt
file.

gcc/ChangeLog
	PR other/122243
	* config/cris/cris.opt (m32-bit, m16-bit, m8-bit): Remove
	Undocumented property.
	(m32bit, m8bit): Add Undocumented property.
	* doc/invoke.texi (Option Summary) <CRIS Options>: Remove
	obsolete -melf and -maout options from table, plus redundant
	-mno-mul-bug-workaround.
	(CRIS Options): Add @opindex for -mno- forms that didn't already
	have one.  Remove obsolete -melf documentation.  Document
	-mbest-lib-options, -moverride-best-lib-options,
	-mtrap-using-break8, -mtrap-unaligned-atomic, and
	-munaligned-atomic-may-use-library.

diff --git a/gcc/config/cris/cris.opt b/gcc/config/cris/cris.opt
index 9fa9cbfe38c0f1490a74d2aa96f6f0a305ee5796..55b03ee1f79c20c508ae6db7343112a2ae4122fd 100644 (file)
--- a/gcc/config/cris/cris.opt
+++ b/gcc/config/cris/cris.opt
@@ -108,28 +108,32 @@ Do not tune code and read-only data alignment.
 
 ; See cris_handle_option.
 m32-bit
-Target RejectNegative Undocumented
+Target RejectNegative
+Align code and data to 32 bits.
 
 ; See cris_handle_option.
 m32bit
-Target RejectNegative
+Target RejectNegative Undocumented
 Align code and data to 32 bits.
 
 ; See cris_handle_option.
 m16-bit
-Target RejectNegative Undocumented
+Target RejectNegative
+Align code and data to 16 bits.
 
 ; See cris_handle_option.
 m16bit
 Target RejectNegative Undocumented
+Align code and data to 16 bits.
 
 ; See cris_handle_option.
 m8-bit
-Target RejectNegative Undocumented
+Target RejectNegative
+Don't align items in code or data.
 
 ; See cris_handle_option.
 m8bit
-Target RejectNegative
+Target RejectNegative Undocumented
 Don't align items in code or data.
 
 ; TARGET_PROLOGUE_EPILOGUE: Whether or not to omit function

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index d150c6654ec23286b864061b2d82cc6db6140dcd..6821a0ce1b38088709d38986fed2c44cf3372e8a 100644 (file)
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -1010,8 +1010,11 @@ Objective-C and Objective-C++ Dialects}.
 -metrax4  -metrax100  -mpdebug  -mcc-init  -mno-side-effects
 -mstack-align  -mdata-align  -mconst-align
 -m32-bit  -m16-bit  -m8-bit  -mno-prologue-epilogue
--melf  -maout  -sim  -sim2
--mmul-bug-workaround  -mno-mul-bug-workaround}
+-mbest-lib-options  -moverride-best-lib-options
+-mtrap-using-break8  -mtrap-unaligned-atomic
+-munaligned-atomic-may-use-library
+-sim  -sim2
+-mmul-bug-workaround}
 
 @emph{C-SKY Options} (@ref{C-SKY Options})
 @gccoptlist{-march=@var{arch}  -mcpu=@var{cpu}
@@ -26407,6 +26410,8 @@ Warn when the stack frame of a function exceeds @var{n} bytes.
 
 @opindex metrax4
 @opindex metrax100
+@opindex mno-etrax4
+@opindex mno-etrax100
 @item -metrax4
 @itemx -metrax100
 The options @option{-metrax4} and @option{-metrax100} are synonyms for
@@ -26420,6 +26425,7 @@ Work around a bug in the @code{muls} and @code{mulu} instructions for CPU
 models where it applies.  This option is disabled by default.
 
 @opindex mpdebug
+@opindex mno-pddebug
 @item -mpdebug
 Enable CRIS-specific verbose debug-related information in the assembly
 code.  This option also has the effect of turning off the @samp{#NO_APP}
@@ -26427,6 +26433,7 @@ formatted-code indicator to the assembler at the beginning of the
 assembly file.
 
 @opindex mcc-init
+@opindex mno-cc-init
 @item -mcc-init
 Do not use condition-code results from previous instruction; always emit
 compare and test instructions before use of condition codes.
@@ -26476,9 +26483,32 @@ option only together with visual inspection of the compiled code: no
 warnings or errors are generated when call-saved registers must be saved,
 or storage for local variables needs to be allocated.
 
-@opindex melf
-@item -melf
-Legacy no-op option.
+@opindex mbest-lib-options
+@opindex moverride-best-lib-options
+@item -mbest-lib-options
+@itemx -moverride-best-lib-options
+@option{-mbest-lib-options} selects the most feature-enabling options
+allowed by other options.  This option has no @samp{no-} form, but
+@option{-moverride-best-lib-options} disables it regardless of the relative
+order of the two options on the command line.
+
+@opindex mtrap-using-break8
+@opindex mno-trap-using-break8
+@item -mtrap-using-break8
+Emit traps as @samp{break 8}.  This is the default for CRIS v3 and up.  If
+disabled, calls to @code{abort} are used instead.
+
+@opindex mtrap-unaligned-atomic
+@opindex mno-trap-unaligned-atomic
+@item -mtrap-unaligned-atomic
+Emit checks causing @samp{break 8} instructions to execute when
+applying atomic builtins on misaligned memory.
+
+@opindex munaligned-atomic-may-use-library
+@opindex mno-unaligned-atomic-may-use-library
+@item -munaligned-atomic-may-use-library
+Handle atomic builtins that may be applied to unaligned data by calling
+library functions.  This option overrides @option{-mtrap-unaligned-atomic}.
 
 @opindex sim
 @item -sim