diff mbox series

[14/20] doc, mn10300: Clean up MN10300 option documentation [PR122243]

Message ID 20251207001030.1024365-15-sloosemore@baylibre.com
State Committed
Commit 59df2037d0451d2cbcb8e1798054586bb19e159e
Headers
Series Second set of doc updates for target-specific options |

Commit Message

Sandra Loosemore Dec. 7, 2025, 12:10 a.m. UTC 
  gcc/ChangeLog
	PR other/122243
	* doc/invoke.texi (Option Summary) <MN10300 Options>: Remove
	redundant -mno- forms from the list.
	(MN10300 Options): Combine the documentation for -mmult-bug,
	-mam33, -mliw, and -msetlb with the entries for the respective
	negative forms.  List and index the negative forms -mno-am33-2,
	-mno-am34, -mno-return-pointer-on-d0, -mno-mul.x.
---
 gcc/doc/invoke.texi | 71 +++++++++++++++++++++++----------------------
 1 file changed, 36 insertions(+), 35 deletions(-)
diff mbox series

Patch

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index b8787f1f408..20947fd5e30 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -1251,10 +1251,10 @@  Objective-C and Objective-C++ Dialects}.
 
 @emph{MN10300 Options} (@ref{MN10300 Options})
 @gccoptlist{-mmult-bug  -mno-mult-bug
--mno-am33  -mam33  -mam33-2  -mam34
+-mam33  -mam33-2  -mam34
 -mtune=@var{cpu-type}
--mreturn-pointer-on-d0
--mno-crt0  -mrelax  -mliw  -msetlb}
+-mno-return-pointer-on-d0
+-mno-crt0  -mrelax  -mno-liw  -mno-setlb}
 
 @emph{Moxie Options} (@ref{Moxie Options})
 @gccoptlist{-meb  -mel  -mmul.x  -mno-crt0}
@@ -31044,31 +31044,32 @@  These @option{-m} options are defined for Matsushita MN10300 architectures:
 
 @table @gcctabopt
 @opindex mmult-bug
-@item -mmult-bug
-Generate code to avoid bugs in the multiply instructions for the MN10300
-processors.  This is the default.
-
 @opindex mno-mult-bug
-@item -mno-mult-bug
-Do not generate code to avoid bugs in the multiply instructions for the
-MN10300 processors.
+@item -mmult-bug
+@itemx -mno-mult-bug
+When enabled, generate code to avoid bugs in the multiply instructions
+for the MN10300 processors.  This is the default.
 
 @opindex mam33
-@item -mam33
-Generate code using features specific to the AM33 processor.
-
 @opindex mno-am33
-@item -mno-am33
-Do not generate code using features specific to the AM33 processor.  This
-is the default.
+@item -mam33
+@itemx -mno-am33
+Generate code using features specific to the AM33 processor.
+The default is @option{-mno-am33}.
 
 @opindex mam33-2
+@opindex mno-am33-2
 @item -mam33-2
+@itemx -mno-am33-2
 Generate code using features specific to the AM33/2.0 processor.
+The default is @option{-mno-am33-2}.
 
 @opindex mam34
+@opindex mno-am34
 @item -mam34
+@itemx -mno-am34
 Generate code using features specific to the AM34 processor.
+The default is @option{-mno-am34}.
 
 @opindex mtune
 @item -mtune=@var{cpu-type}
@@ -31078,7 +31079,9 @@  type.  The CPU type must be one of @samp{mn10300}, @samp{am33},
 @samp{am33-2} or @samp{am34}.
 
 @opindex mreturn-pointer-on-d0
+@opindex mno-return-pointer-on-d0
 @item -mreturn-pointer-on-d0
+@itemx -mno-return-pointer-on-d0
 When generating a function that returns a pointer, return the pointer
 in both @code{a0} and @code{d0}.  Otherwise, the pointer is returned
 only in @code{a0}, and attempts to call such functions without a prototype
@@ -31098,28 +31101,24 @@  has an effect when used on the command line for the final link step.
 This option makes symbolic debugging impossible.
 
 @opindex mliw
-@item -mliw
-Allow the compiler to generate @emph{Long Instruction Word}
-instructions if the target is the @samp{AM33} or later.  This is the
-default.  This option defines the preprocessor macro @code{__LIW__}.
-
 @opindex mno-liw
-@item -mno-liw
-Do not allow the compiler to generate @emph{Long Instruction Word}
-instructions.  This option defines the preprocessor macro
-@code{__NO_LIW__}.
+@item -mliw
+@itemx -mno-liw
+Allow the compiler to generate @emph{Long Instruction Word}
+instructions if the target is the @samp{AM33} or later.  This option is
+enabled by default.
+@option{-mliw} defines the preprocessor macro @code{__LIW__};
+@option{-mno-liw} defines the preprocessor macro @code{__NO_LIW__}.
 
 @opindex msetlb
-@item -msetlb
-Allow the compiler to generate the @emph{SETLB} and @emph{Lcc}
-instructions if the target is the @samp{AM33} or later.  This is the
-default.  This option defines the preprocessor macro @code{__SETLB__}.
-
 @opindex mno-setlb
-@item -mno-setlb
-Do not allow the compiler to generate @emph{SETLB} or @emph{Lcc}
-instructions.  This option defines the preprocessor macro
-@code{__NO_SETLB__}.
+@item -msetlb
+@itemx -mno-setlb
+Allow the compiler to generate the @emph{SETLB} and @emph{Lcc}
+instructions if the target is the @samp{AM33} or later.  This option is
+enabled by default.
+@option{-msetlb} defines the preprocessor macro @code{__SETLB__};
+@option{-mno-setlb} defines the preprocessor macro @code{__NO_SETLB__}.
 
 @end table
 
@@ -31139,8 +31138,10 @@  configurations.
 Generate little-endian code.
 
 @opindex mmul.x
+@opindex mno-mul.x
 @item -mmul.x
-Generate mul.x and umul.x instructions.  This is the default for
+@itemx -mno-mul.x
+Generate mul.x and umul.x instructions.  This option is enabled by default for
 @samp{moxiebox-*-*} configurations.
 
 @opindex mno-crt0