docs: Reorder @opindex before corresponding options

gcc/d/ChangeLog:

	* gdc.texi: Reorder @opindex commands to precede @items they
	relate to.

gcc/ChangeLog:

	* doc/cppdiropts.texi: Reorder @opindex commands to precede
	@items they relate to.
	* doc/cppopts.texi: Ditto.
	* doc/cppwarnopts.texi: Ditto.
	* doc/invoke.texi: Ditto.
	* doc/lto.texi: Ditto.

gcc/fortran/ChangeLog:

	* invoke.texi: Reorder @opindex commands to precede @items they
	relate to.

1 files changed, 72 insertions, 72 deletions

diff --git a/gcc/d/gdc.texi b/gcc/d/gdc.texi
index 1c79c8c..24b6ee0 100644
--- a/gcc/d/gdc.texi
+++ b/gcc/d/gdc.texi
@@ -171,30 +171,30 @@ These options affect the runtime behavior of programs compiled with
 
 @table @gcctabopt
 
-@item -fall-instantiations
 @opindex fall-instantiations
 @opindex fno-all-instantiations
+@item -fall-instantiations
 Generate code for all template instantiations.  The default template emission
 strategy is to not generate code for declarations that were either
 instantiated speculatively, such as from @code{__traits(compiles, ...)}, or
 that come from an imported module not being compiled.
 
-@item -fno-assert
 @opindex fassert
 @opindex fno-assert
+@item -fno-assert
 Turn off code generation for @code{assert} contracts.
 
-@item -fno-bounds-check
 @opindex fbounds-check
 @opindex fno-bounds-check
+@item -fno-bounds-check
 Turns off array bounds checking for all functions, which can improve
 performance for code that uses arrays extensively.  Note that this
 can result in unpredictable behavior if the code in question actually
 does violate array bounds constraints.  It is safe to use this option
 if you are sure that your code never throws a @code{RangeError}.
 
-@item -fbounds-check=@var{value}
 @opindex fbounds-check=
+@item -fbounds-check=@var{value}
 An alternative to @option{-fbounds-check} that allows more control
 as to where bounds checking is turned on or off.  The following values
 are supported:
@@ -208,15 +208,15 @@ Turns on array bounds checking only for @code{@@safe} functions.
 Turns off array bounds checking completely.
 @end table
 
-@item -fno-builtin
 @opindex fbuiltin
 @opindex fno-builtin
+@item -fno-builtin
 Don't recognize built-in functions unless they begin with the prefix
 @samp{__builtin_}.  By default, the compiler will recognize when a
 function in the @code{core.stdc} package is a built-in function.
 
-@item -fcheckaction=@var{value}
 @opindex fcheckaction
+@item -fcheckaction=@var{value}
 This option controls what code is generated on an assertion, bounds check, or
 final switch failure.  The following values are supported:
 
@@ -229,10 +229,10 @@ Halt the program execution.
 Throw an @code{AssertError} (the default).
 @end table
 
-@item -fdebug
-@item -fdebug=@var{value}
 @opindex fdebug
 @opindex fno-debug
+@item -fdebug
+@item -fdebug=@var{value}
 Turn on compilation of conditional @code{debug} code into the program.
 The @option{-fdebug} option itself sets the debug level to @code{1},
 while @option{-fdebug=} enables @code{debug} code that are identified
@@ -243,9 +243,9 @@ by any of the following values:
 Turns on compilation of any @code{debug} code identified by @var{ident}.
 @end table
 
-@item -fno-druntime
 @opindex fdruntime
 @opindex fno-druntime
+@item -fno-druntime
 Implements @uref{https://dlang.org/spec/betterc.html}.  Assumes that
 compilation targets an environment without a D runtime library.
 
@@ -255,8 +255,8 @@ This is equivalent to compiling with the following options:
 gdc -nophoboslib -fno-exceptions -fno-moduleinfo -fno-rtti
 @end example
 
-@item -fextern-std=@var{standard}
 @opindex fextern-std
+@item -fextern-std=@var{standard}
 Sets the C++ name mangling compatibility to the version identified by
 @var{standard}.  The following values are supported:
 
@@ -275,21 +275,21 @@ This is the default.
 Sets @code{__traits(getTargetInfo, "cppStd")} to @code{202002}.
 @end table
 
-@item -fno-invariants
 @opindex finvariants
 @opindex fno-invariants
+@item -fno-invariants
 Turns off code generation for class @code{invariant} contracts.
 
-@item -fmain
 @opindex fmain
+@item -fmain
 Generates a default @code{main()} function when compiling.  This is useful when
 unittesting a library, as it enables running the unittests in a library without
 having to manually define an entry-point function.  This option does nothing
 when @code{main} is already defined in user code.
 
-@item -fno-moduleinfo
 @opindex fmoduleinfo
 @opindex fno-moduleinfo
+@item -fno-moduleinfo
 Turns off generation of the @code{ModuleInfo} and related functions
 that would become unreferenced without it, which may allow linking
 to programs not written in D.  Functions that are not be generated
@@ -297,24 +297,24 @@ include module constructors and destructors (@code{static this} and
 @code{static ~this}), @code{unittest} code, and @code{DSO} registry
 functions for dynamically linked code.
 
-@item -fonly=@var{filename}
 @opindex fonly
+@item -fonly=@var{filename}
 Tells the compiler to parse and run semantic analysis on all modules
 on the command line, but only generate code for the module specified
 by @var{filename}.
 
-@item -fno-postconditions
 @opindex fpostconditions
 @opindex fno-postconditions
+@item -fno-postconditions
 Turns off code generation for postcondition @code{out} contracts.
 
-@item -fno-preconditions
 @opindex fpreconditions
 @opindex fno-preconditions
+@item -fno-preconditions
 Turns off code generation for precondition @code{in} contracts.
 
-@item -fpreview=@var{id}
 @opindex fpreview
+@item -fpreview=@var{id}
 Turns on an upcoming D language change identified by @var{id}.  The following
 values are supported:
 
@@ -359,9 +359,9 @@ Implements rvalue arguments to @code{ref} parameters.
 Disables access to variables marked @code{@@system} from @code{@@safe} code.
 @end table
 
-@item -frelease
 @opindex frelease
 @opindex fno-release
+@item -frelease
 Turns on compiling in release mode, which means not emitting runtime
 checks for contracts and asserts.  Array bounds checking is not done
 for @code{@@system} and @code{@@trusted} functions, and assertion
@@ -374,8 +374,8 @@ gdc -fno-assert -fbounds-check=safe -fno-invariants \
     -fno-postconditions -fno-preconditions -fno-switch-errors
 @end example
 
-@item -frevert=
 @opindex frevert
+@item -frevert=
 Turns off a D language feature identified by @var{id}.  The following values
 are supported:
 
@@ -395,29 +395,29 @@ Turns off C-style integral promotion for unary @code{+}, @code{-} and @code{~}
 expressions.
 @end table
 
-@item -fno-rtti
 @opindex frtti
 @opindex fno-rtti
+@item -fno-rtti
 Turns off generation of run-time type information for all user defined types.
 Any code that uses features of the language that require access to this
 information will result in an error.
 
-@item -fno-switch-errors
 @opindex fswitch-errors
 @opindex fno-switch-errors
+@item -fno-switch-errors
 This option controls what code is generated when no case is matched
 in a @code{final switch} statement.  The default run time behavior
 is to throw a @code{SwitchError}.  Turning off @option{-fswitch-errors}
 means that instead the execution of the program is immediately halted.
 
-@item -funittest
 @opindex funittest
 @opindex fno-unittest
+@item -funittest
 Turns on compilation of @code{unittest} code, and turns on the
 @code{version(unittest)} identifier.  This implies @option{-fassert}.
 
-@item -fversion=@var{value}
 @opindex fversion
+@item -fversion=@var{value}
 Turns on compilation of conditional @code{version} code into the program
 identified by any of the following values:
 
@@ -426,9 +426,9 @@ identified by any of the following values:
 Turns on compilation of @code{version} code identified by @var{ident}.
 @end table
 
-@item -fno-weak-templates
 @opindex fweak-templates
 @opindex fno-weak-templates
+@item -fno-weak-templates
 Turns off emission of declarations that can be defined in multiple objects as
 weak symbols.  The default is to emit all public symbols as weak, unless the
 target lacks support for weak symbols.  Disabling this option means that common
@@ -447,30 +447,30 @@ other parts of the compiler:
 
 @table @gcctabopt
 
-@item -I@var{dir}
 @opindex I
+@item -I@var{dir}
 Specify a directory to use when searching for imported modules at
 compile time.  Multiple @option{-I} options can be used, and the
 paths are searched in the same order.
 
-@item -J@var{dir}
 @opindex J
+@item -J@var{dir}
 Specify a directory to use when searching for files in string imports
 at compile time.  This switch is required in order to use
 @code{import(file)} expressions.  Multiple @option{-J} options can be
 used, and the paths are searched in the same order.
 
-@item -L@var{dir}
 @opindex L
+@item -L@var{dir}
 When linking, specify a library search directory, as with @command{gcc}.
 
-@item -B@var{dir}
 @opindex B
+@item -B@var{dir}
 This option specifies where to find the executables, libraries,
 source files, and data files of the compiler itself, as with @command{gcc}.
 
-@item -fmodule-file=@var{module}=@var{spec}
 @opindex fmodule-file
+@item -fmodule-file=@var{module}=@var{spec}
 This option manipulates file paths of imported modules, such that if an
 imported module matches all or the leftmost part of @var{module}, the file
 path in @var{spec} is used as the location to search for D sources.
@@ -492,19 +492,19 @@ import C.D.E;   // Matches C, searches for bar/D/E.d
 import A.B.C;   // No match, searches for A/B/C.d
 @end example
 
-@item -imultilib @var{dir}
 @opindex imultilib
+@item -imultilib @var{dir}
 Use @var{dir} as a subdirectory of the gcc directory containing
 target-specific D sources and interfaces.
 
-@item -iprefix @var{prefix}
 @opindex iprefix
+@item -iprefix @var{prefix}
 Specify @var{prefix} as the prefix for the gcc directory containing
 target-specific D sources and interfaces.  If the @var{prefix} represents
 a directory, you should include the final @code{'/'}.
 
-@item -nostdinc
 @opindex nostdinc
+@item -nostdinc
 Do not search the standard system directories for D source and interface
 files.  Only the directories that have been specified with @option{-I} options
 (and the directory of the current file, if appropriate) are searched.
@@ -520,107 +520,107 @@ In addition to the many @command{gcc} options controlling code generation,
 
 @table @gcctabopt
 
-@item -H
 @opindex H
+@item -H
 Generates D interface files for all modules being compiled.  The compiler
 determines the output file based on the name of the input file, removes
 any directory components and suffix, and applies the @file{.di} suffix.
 
-@item -Hd @var{dir}
 @opindex Hd
+@item -Hd @var{dir}
 Same as @option{-H}, but writes interface files to directory @var{dir}.
 This option can be used with @option{-Hf @var{file}} to independently set the
 output file and directory path.
 
-@item -Hf @var{file}
 @opindex Hf
+@item -Hf @var{file}
 Same as @option{-H} but writes interface files to @var{file}.  This option can
 be used with @option{-Hd @var{dir}} to independently set the output file and
 directory path.
 
-@item -M
 @opindex M
+@item -M
 Output the module dependencies of all source files being compiled in a
 format suitable for @command{make}.  The compiler outputs one
 @command{make} rule containing the object file name for that source file,
 a colon, and the names of all imported files.
 
-@item -MM
 @opindex MM
+@item -MM
 Like @option{-M} but does not mention imported modules from the D standard
 library package directories.
 
-@item -MF @var{file}
 @opindex MF
+@item -MF @var{file}
 When used with @option{-M} or @option{-MM}, specifies a @var{file} to write
 the dependencies to.  When used with the driver options @option{-MD} or
 @option{-MMD}, @option{-MF} overrides the default dependency output file.
 
-@item -MG
 @opindex MG
+@item -MG
 This option is for compatibility with @command{gcc}, and is ignored by the
 compiler.
 
-@item -MP
 @opindex MP
+@item -MP
 Outputs a phony target for each dependency other than the modules being
 compiled, causing each to depend on nothing.
 
-@item -MT @var{target}
 @opindex MT
+@item -MT @var{target}
 Change the @var{target} of the rule emitted by dependency generation
 to be exactly the string you specify.  If you want multiple targets,
 you can specify them as a single argument to @option{-MT}, or use
 multiple @option{-MT} options.
 
-@item -MQ @var{target}
 @opindex MQ
+@item -MQ @var{target}
 Same as @option{-MT}, but it quotes any characters which are special to
 @command{make}.
 
-@item -MD
 @opindex MD
+@item -MD
 This option is equivalent to @option{-M -MF @var{file}}.  The driver
 determines @var{file} by removing any directory components and suffix
 from the input file, and then adding a @file{.deps} suffix.
 
-@item -MMD
 @opindex MMD
+@item -MMD
 Like @option{-MD} but does not mention imported modules from the D standard
 library package directories.
 
-@item -X
 @opindex X
+@item -X
 Output information describing the contents of all source files being
 compiled in JSON format to a file.  The driver determines @var{file} by
 removing any directory components and suffix from the input file, and then
 adding a @file{.json} suffix.
 
-@item -Xf @var{file}
 @opindex Xf
+@item -Xf @var{file}
 Same as @option{-X}, but writes all JSON contents to the specified
 @var{file}.
 
-@item -fdoc
 @opindex fdoc
+@item -fdoc
 Generates @code{Ddoc} documentation and writes it to a file.  The compiler
 determines @var{file} by removing any directory components and suffix
 from the input file, and then adding a @file{.html} suffix.
 
-@item -fdoc-dir=@var{dir}
 @opindex fdoc-dir
+@item -fdoc-dir=@var{dir}
 Same as @option{-fdoc}, but writes documentation to directory @var{dir}.
 This option can be used with @option{-fdoc-file=@var{file}} to
 independently set the output file and directory path.
 
-@item -fdoc-file=@var{file}
 @opindex fdoc-file
+@item -fdoc-file=@var{file}
 Same as @option{-fdoc}, but writes documentation to @var{file}.  This
 option can be used with @option{-fdoc-dir=@var{dir}} to independently
 set the output file and directory path.
 
-@item -fdoc-inc=@var{file}
 @opindex fdoc-inc
+@item -fdoc-inc=@var{file}
 Specify @var{file} as a @var{Ddoc} macro file to be read.  Multiple
 @option{-fdoc-inc} options can be used, and files are read and processed
 in the same order.
@@ -632,8 +632,8 @@ For D source files, generate corresponding C++ declarations in @var{file}.
 In conjunction with @option{-fdump-c++-spec=} above, add comments for ignored
 declarations in the generated C++ header.
 
-@item -fsave-mixins=@var{file}
 @opindex fsave-mixins
+@item -fsave-mixins=@var{file}
 Generates code expanded from D @code{mixin} statements and writes the
 processed sources to @var{file}.  This is useful to debug errors in compilation
 and provides source for debuggers to show when requested.
@@ -656,93 +656,93 @@ specified, they do not prevent compilation of the program.
 
 @table @gcctabopt
 
-@item -Wall
 @opindex Wall
 @opindex Wno-all
+@item -Wall
 Turns on all warnings messages.  Warnings are not a defined part of
 the D language, and all constructs for which this may generate a
 warning message are valid code.
 
-@item -Walloca
 @opindex Walloca
+@item -Walloca
 This option warns on all uses of "alloca" in the source.
 
-@item -Walloca-larger-than=@var{n}
 @opindex Walloca-larger-than
 @opindex Wno-alloca-larger-than
+@item -Walloca-larger-than=@var{n}
 Warn on unbounded uses of alloca, and on bounded uses of alloca
 whose bound can be larger than @var{n} bytes.
 @option{-Wno-alloca-larger-than} disables
 @option{-Walloca-larger-than} warning and is equivalent to
 @option{-Walloca-larger-than=@var{SIZE_MAX}} or larger.
 
-@item -Wno-builtin-declaration-mismatch
 @opindex Wno-builtin-declaration-mismatch
 @opindex Wbuiltin-declaration-mismatch
+@item -Wno-builtin-declaration-mismatch
 Warn if a built-in function is declared with an incompatible signature.
 
-@item -Wcast-result
 @opindex Wcast-result
 @opindex Wno-cast-result
+@item -Wcast-result
 Warn about casts that will produce a null or zero result.  Currently
 this is only done for casting between an imaginary and non-imaginary
 data type, or casting between a D and C++ class.
 
-@item -Wno-deprecated
 @opindex Wdeprecated
 @opindex Wno-deprecated
+@item -Wno-deprecated
 Do not warn about usage of deprecated features and symbols with
 @code{deprecated} attributes.
 
-@item -Werror
 @opindex Werror
 @opindex Wno-error
+@item -Werror
 Turns all warnings into errors.
 
-@item -Wspeculative
 @opindex Wspeculative
 @opindex Wno-speculative
+@item -Wspeculative
 List all error messages from speculative compiles, such as
 @code{__traits(compiles, ...)}.  This option does not report
 messages as warnings, and these messages therefore never become
 errors when the @option{-Werror} option is also used.
 
-@item -Wunknown-pragmas
 @opindex Wunknown-pragmas
 @opindex Wno-unknown-pragmas
+@item -Wunknown-pragmas
 Warn when a @code{pragma()} is encountered that is not understood by
 @command{gdc}.  This differs from @option{-fignore-unknown-pragmas}
 where a pragma that is part of the D language, but not implemented by
 the compiler, won't get reported.
 
-@item -Wno-varargs
 @opindex Wvarargs
 @opindex Wno-varargs
+@item -Wno-varargs
 Do not warn upon questionable usage of the macros used to handle variable
 arguments like @code{va_start}.
 
-@item -fignore-unknown-pragmas
 @opindex fignore-unknown-pragmas
 @opindex fno-ignore-unknown-pragmas
+@item -fignore-unknown-pragmas
 Turns off errors for unsupported pragmas.
 
-@item -fmax-errors=@var{n}
 @opindex fmax-errors
+@item -fmax-errors=@var{n}
 Limits the maximum number of error messages to @var{n}, at which point
 @command{gdc} bails out rather than attempting to continue processing the
 source code.  If @var{n} is 0 (the default), there is no limit on the
 number of error messages produced.
 
-@item -fsyntax-only
 @opindex fsyntax-only
 @opindex fno-syntax-only
+@item -fsyntax-only
 Check the code for syntax errors, but do not actually compile it.  This
 can be used in conjunction with @option{-fdoc} or @option{-H} to generate
 files for each module present on the command-line, but no other output
 file.
 
-@item -ftransition=@var{id}
 @opindex ftransition
+@item -ftransition=@var{id}
 Report additional information about D language changes identified by
 @var{id}.  The following values are supported:
 
@@ -776,35 +776,35 @@ a link step.
 
 @table @gcctabopt
 
-@item -defaultlib=@var{libname}
 @opindex defaultlib=
+@item -defaultlib=@var{libname}
 Specify the library to use instead of libphobos when linking.  Options
 specifying the linkage of libphobos, such as @option{-static-libphobos}
 or @option{-shared-libphobos}, are ignored.
 
-@item -debuglib=@var{libname}
 @opindex debuglib=
+@item -debuglib=@var{libname}
 Specify the debug library to use instead of libphobos when linking.
 This option has no effect unless the @option{-g} option was also given
 on the command line.  Options specifying the linkage of libphobos, such
 as @option{-static-libphobos} or @option{-shared-libphobos}, are ignored.
 
-@item -nophoboslib
 @opindex nophoboslib
+@item -nophoboslib
 Do not use the Phobos or D runtime library when linking.  Options specifying
 the linkage of libphobos, such as @option{-static-libphobos} or
 @option{-shared-libphobos}, are ignored.  The standard system libraries are
 used normally, unless @option{-nostdlib} or @option{-nodefaultlibs} is used.
 
-@item -shared-libphobos
 @opindex shared-libphobos
+@item -shared-libphobos
 On systems that provide @file{libgphobos} and @file{libgdruntime} as a
 shared and a static library, this option forces the use of the shared
 version.  If no shared version was built when the compiler was configured,
 this option has no effect.
 
-@item -static-libphobos
 @opindex static-libphobos
+@item -static-libphobos
 On systems that provide @file{libgphobos} and @file{libgdruntime} as a
 shared and a static library, this option forces the use of the static
 version.  If no static version was built when the compiler was configured,
@@ -823,13 +823,13 @@ interest to developers or language tooling.
 
 @table @gcctabopt
 
-@item -fdump-d-original
 @opindex fdump-d-original
+@item -fdump-d-original
 Output the internal front-end AST after the @code{semantic3} stage.
 This option is only useful for debugging the GNU D compiler itself.
 
-@item -v
 @opindex v
+@item -v
 Dump information about the compiler language processing stages as the source
 program is being compiled.  This includes listing all modules that are
 processed through the @code{parse}, @code{semantic}, @code{semantic2}, and