doc, v850: Clean up V850 options and documentation [PR122243]

gcc/ChangeLog
	PR other/122243
	* config/v850/v850.opt: Copy-edit documentation strings.
	(mdebug): Make Undocumented.
	(mno-strict-align): Add RejectNegative.
	(mUS-bit-set): Make Undocumented.
	* doc/invoke.texi (Option Summary) <V850 Options>: Remove
	redundant -mno- forms from list.  Add missing entries.
	(V850 Options): Add @opindex for negative forms.  Combine
	entries for -mapp-regs and -mno-app-regs.  Document -msmall-sld,
	-mno-strict-align, and -mjump-tables-in-data-section.

diff --git a/gcc/config/v850/v850.opt b/gcc/config/v850/v850.opt
index ad10065f7156794851d8f1202a998293c392da84..ef18945d1e0c7e2c2a2f5584485b7760f3e38cb0 100644 (file)
--- a/gcc/config/v850/v850.opt
+++ b/gcc/config/v850/v850.opt
@@ -33,7 +33,7 @@ Target Mask(BIG_SWITCH)
 Use 4 byte entries in switch tables.
 
 mdebug
-Target Mask(DEBUG)
+Target Undocumented Mask(DEBUG)
 Enable backend debugging.
 
 mdisable-callt
@@ -42,14 +42,15 @@ Do not use the callt instruction (default).
 
 mep
 Target Mask(EP)
-Reuse r30 on a per function basis.
+Reuse r30 on a per-function basis.
 
 mghs
 Target RejectNegative InverseMask(GCC_ABI) MaskExists
+Alias for -mrh850-abi.
 
 mlong-calls
 Target Mask(LONG_CALLS)
-Prohibit PC relative function calls.
+Prohibit PC-relative function calls.
 
 mprolog-function
 Target Mask(PROLOG_FUNCTION)
@@ -78,15 +79,16 @@ mtda-
 Target RejectNegative Joined Undocumented Alias(mtda=)
 
 mno-strict-align
-Target Mask(NO_STRICT_ALIGN)
+Target RejectNegative Mask(NO_STRICT_ALIGN)
 Do not enforce strict alignment.
 
 mjump-tables-in-data-section
 Target Mask(JUMP_TABLES_IN_DATA_SECTION)
 Put jump tables for switch statements into the .data section rather than the .code section.
 
+; Not used or documented anywhere.
 mUS-bit-set
-Target Mask(US_BIT_SET)
+Target Undocumented Mask(US_BIT_SET)
 
 mv850
 Target RejectNegative Mask(V850)

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 676aa2ba668c158a490d01eb00001fbf8a11ad68..3a53d42e4c68f52d0d952300d2d9b6c990488ec8 100644 (file)
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -1471,21 +1471,16 @@ See RS/6000 and PowerPC Options.
 @gccoptlist{-YP,@var{paths}  -Ym,@var{dir}}
 
 @emph{V850 Options} (@ref{V850 Options})
-@gccoptlist{-mlong-calls  -mno-long-calls  -mep  -mno-ep
--mprolog-function  -mno-prolog-function  -mspace
+@gccoptlist{-mlong-calls  -mep
+-mprolog-function  -mspace
 -mtda=@var{n}  -msda=@var{n}  -mzda=@var{n}
--mapp-regs  -mno-app-regs
--mdisable-callt  -mno-disable-callt
--mv850e2v3  -mv850e2  -mv850e1  -mv850es
--mv850e  -mv850  -mv850e3v5
--mloop
--mrelax
--mlong-jumps
--msoft-float
--mhard-float
--mgcc-abi
--mrh850-abi
--mbig-switch}
+-mv850  -mv850e3v5  -m850e2v4  -mv850e2v3
+-mv850e2  -mv850e1  -mv850es  -mv850e
+-mdisable-callt  -mrelax  -mlong-jumps
+-msoft-float  -mhard-float  -mloop
+-mrh850-abi  -mghs  -mgcc-abi
+-m8byte-align  -mbig-switch  -mapp-regs  -msmall-sld
+-mno-strict-align  -mjump-tables-in-data-section}
 
 @emph{VAX Options} (@ref{VAX Options})
 @gccoptlist{-munix  -mgnu  -md  -md-float  -mg  -mg-float  -mlra}
@@ -35522,20 +35517,38 @@ alignment of all objects to at most 4-bytes.  When
 @code{__V850_8BYTE_ALIGN__} is defined.
 
 @opindex mbig-switch
+@opindex mno-big-switch
 @item -mbig-switch
+@itemx -mno-big-switch
 Generate code suitable for big switch tables.  Use this option only if
 the assembler/linker complain about out of range branches within a switch
 table.
 
 @opindex mapp-regs
+@opindex mno-app-regs
 @item -mapp-regs
-This option causes r2 and r5 to be used in the code generated by
-the compiler.  This setting is the default.
+@itemx -mno-app-regs
+@option{-mapp-regs} causes r2 and r5 to be used in the code generated by
+the compiler.  This setting is the default.  @option{-mno-app-regs}
+causes r2 and r5 to be treated as fixed registers.
 
-@opindex mno-app-regs
-@item -mno-app-regs
-This option causes r2 and r5 to be treated as fixed registers.
+@opindex msmall-sld
+@opindex mno-small-sld
+@item -msmall-sld
+@itemx -mno-small-sld
+Enable or disable the use of the short load instructions.
 
+@opindex mno-strict-align
+@item -mno-strict-align
+Do not enforce strict data alignment.
+
+@opindex mjump-tables-in-data-section
+@opindex mno-jump-tables-in-data-section
+@item -mjump-tables-in-data-section
+@itemx -mno-jump-tables-in-data-section
+Enable or disable placement of jump tables for switch statements in
+the @code{.data} section rather than the @code{.code} section.  The
+default is @option{-mno-jump-tables-in-data-section}.
 @end table
 
 @node VAX Options