Skip to content

R
riscv-gcc-1
Commit 32864778 by Daniel Franke Committed by Daniel Franke
Options

gfortran.texi: Added node and menu entry for an option index. 

2007-04-27  Daniel Franke  <franke.daniel@gmail.com>

	* gfortran.texi: Added node and menu entry for an option index.
	* invoke.texi: Moved command line option related entries of the concept 
	index to the option index.

From-SVN: r124224
parent a56c06d8
Showing with 97 additions and 131 deletions
gcc/fortran/ChangeLog
2007-04-27 Daniel Franke <franke.daniel@gmail.com> 2007-04-27 Daniel Franke <franke.daniel@gmail.com>
* gfortran.texi: Added node and menu entry for an option index.
* invoke.texi: Moved command line option related entries of the concept
index to the option index.
2007-04-27 Daniel Franke <franke.daniel@gmail.com>
* intrinsic.texi (AND, FPUT, FPUTC, MODULO, OR, SET_EXPONENT, * intrinsic.texi (AND, FPUT, FPUTC, MODULO, OR, SET_EXPONENT,
XOR): Fixed examples. XOR): Fixed examples.
......
gcc/fortran/gfortran.texi
...@@ -191,7 +191,8 @@ Part II: Language Reference ...@@ -191,7 +191,8 @@ Part II: Language Reference
* GNU Free Documentation License:: * GNU Free Documentation License::
How you can copy and share this manual. How you can copy and share this manual.
* Funding:: How to help assure continued work for free software. * Funding:: How to help assure continued work for free software.
* Index:: Index of this documentation. * Option Index:: Index of command line options
* Keyword Index:: Index of concepts
@end menu @end menu
@end ifnottex @end ifnottex
...@@ -710,7 +711,7 @@ than @code{(/.../)}. ...@@ -710,7 +711,7 @@ than @code{(/.../)}.
@item @item
@cindex @code{ENUM} statement @cindex @code{ENUM} statement
@cindex @code{ENUMERATOR} statement @cindex @code{ENUMERATOR} statement
@cindex @code{-fshort-enums} option @opindex @code{fshort-enums}
Support for the declaration of enumeration constants via the Support for the declaration of enumeration constants via the
@code{ENUM} and @code{ENUMERATOR} statements. Interoperability with @code{ENUM} and @code{ENUMERATOR} statements. Interoperability with
@command{gcc} is guaranteed also for the case where the @command{gcc} is guaranteed also for the case where the
...@@ -1577,12 +1578,20 @@ Environment variable forcing standard output to be line buffered (unix). ...@@ -1577,12 +1578,20 @@ Environment variable forcing standard output to be line buffered (unix).
@include funding.texi @include funding.texi
@c --------------------------------------------------------------------- @c ---------------------------------------------------------------------
@c Index @c Indices
@c --------------------------------------------------------------------- @c ---------------------------------------------------------------------
@node Index @node Option Index
@unnumbered Index @unnumbered Index of command line options
@command{gfortran}'s command line options are indexed here without any
initial `-' or `--'. Where an option has both positive and negative forms
(such as -foption and -fno-option), relevant entries in the manual are
indexed under the most appropriate form; it may sometimes be useful to
look up both forms.
@printindex op
@node Keyword Index
@unnumbered Index of concepts
@printindex cp @printindex cp
@bye @bye
gcc/fortran/invoke.texi
...@@ -178,10 +178,9 @@ accepted by the compiler: ...@@ -178,10 +178,9 @@ accepted by the compiler:
@table @gcctabopt @table @gcctabopt
@item -ffree-form @item -ffree-form
@item -ffixed-form @item -ffixed-form
@cindex @code{-ffree-form} option @opindex @code{ffree-form}
@cindex option, @code{-ffree-form} @opindex @code{fno-fixed-form}
@cindex @code{-fno-fixed-form} option @cindex options, fortran dialect
@cindex option, @code{-fno-fixed-form}
@cindex source file format @cindex source file format
@cindex free form @cindex free form
@cindex fixed form @cindex fixed form
...@@ -193,8 +192,7 @@ older Fortran programs. When neither option is specified, the source ...@@ -193,8 +192,7 @@ older Fortran programs. When neither option is specified, the source
form is determined by the file extension. form is determined by the file extension.
@item -fall-intrinsics @item -fall-intrinsics
@cindex @code{-fall-intrinsics} option @opindex @code{fall-intrinsics}
@cindex option, @code{-fall-intrinsics}
Accept all of the intrinsic procedures provided in libgfortran Accept all of the intrinsic procedures provided in libgfortran
without regard to the setting of @option{-std}. In particular, without regard to the setting of @option{-std}. In particular,
this option can be quite useful with @option{-std=f95}. Additionally, this option can be quite useful with @option{-std=f95}. Additionally,
...@@ -202,10 +200,8 @@ this option can be quite useful with @option{-std=f95}. Additionally, ...@@ -202,10 +200,8 @@ this option can be quite useful with @option{-std=f95}. Additionally,
@item -fd-lines-as-code @item -fd-lines-as-code
@item -fd-lines-as-comments @item -fd-lines-as-comments
@cindex @code{-fd-lines-as-code}, option @opindex @code{fd-lines-as-code}
@cindex option, @code{-fd-lines-as-code} @opindex @code{fd-lines-as-comments}
@cindex @code{-fd-lines-as-comments}, option
@cindex option, @code{-fd-lines-as-comments}
Enable special treatment for lines beginning with @code{d} or @code{D} Enable special treatment for lines beginning with @code{d} or @code{D}
in fixed form sources. If the @option{-fd-lines-as-code} option is in fixed form sources. If the @option{-fd-lines-as-code} option is
given they are treated as if the first column contained a blank. If the given they are treated as if the first column contained a blank. If the
...@@ -213,52 +209,45 @@ given they are treated as if the first column contained a blank. If the ...@@ -213,52 +209,45 @@ given they are treated as if the first column contained a blank. If the
comment lines. comment lines.
@item -fdefault-double-8 @item -fdefault-double-8
@cindex @code{-fdefault-double-8}, option @opindex @code{fdefault-double-8}
@cindex option, @code{-fdefault-double-8}
Set the @code{DOUBLE PRECISION} type to an 8 byte wide type. Set the @code{DOUBLE PRECISION} type to an 8 byte wide type.
@item -fdefault-integer-8 @item -fdefault-integer-8
@cindex @code{-fdefault-integer-8}, option @opindex @code{fdefault-integer-8}
@cindex option, @code{-fdefault-integer-8}
Set the default integer and logical types to an 8 byte wide type. Set the default integer and logical types to an 8 byte wide type.
Do nothing if this is already the default. Do nothing if this is already the default.
@item -fdefault-real-8 @item -fdefault-real-8
@cindex @code{-fdefault-real-8}, option @opindex @code{fdefault-real-8}
@cindex option, @code{-fdefault-real-8}
Set the default real type to an 8 byte wide type. Set the default real type to an 8 byte wide type.
Do nothing if this is already the default. Do nothing if this is already the default.
@item -fdollar-ok @item -fdollar-ok
@cindex @code{-fdollar-ok} option @opindex @code{fdollar-ok}
@cindex option, @code{-fdollar-ok}
@cindex dollar sign @cindex dollar sign
@cindex symbol names @cindex symbol names
@cindex character set @cindex character set
Allow @samp{$} as a valid character in a symbol name. Allow @samp{$} as a valid character in a symbol name.
@item -fno-backslash @item -fno-backslash
@cindex @code{-fno-backslash} option @opindex @code{fno-backslash}
@cindex option, @code{-fno-backslash}
@cindex backslash @cindex backslash
@cindex escape characters @cindex escape characters
Change the interpretation of backslashes in string literals from Change the interpretation of backslashes in string literals from
``C-style'' escape characters to a single backslash character. ``C-style'' escape characters to a single backslash character.
@item -ffixed-line-length-@var{n} @item -ffixed-line-length-@var{n}
@cindex @code{-ffixed-line-length-}@var{n} option @opindex @code{ffixed-line-length-}@var{n}
@cindex option, @code{-ffixed-line-length-}@var{n}
@cindex source file format @cindex source file format
@cindex lines, length @cindex lines, length
@cindex length of source lines @cindex length of source lines
@cindex fixed form
@cindex limits, lengths of source lines @cindex limits, lengths of source lines
@cindex card image
@cindex extended-source option
Set column after which characters are ignored in typical fixed-form Set column after which characters are ignored in typical fixed-form
lines in the source file, and through which spaces are assumed (as lines in the source file, and through which spaces are assumed (as
if padded to that length) after the ends of short fixed-form lines. if padded to that length) after the ends of short fixed-form lines.
@cindex card image
@cindex extended-source option
Popular values for @var{n} include 72 (the Popular values for @var{n} include 72 (the
standard and the default), 80 (card image), and 132 (corresponding standard and the default), 80 (card image), and 132 (corresponding
to ``extended-source'' options in some popular compilers). to ``extended-source'' options in some popular compilers).
...@@ -269,12 +258,10 @@ to them to fill out the line. ...@@ -269,12 +258,10 @@ to them to fill out the line.
@option{-ffixed-line-length-none}. @option{-ffixed-line-length-none}.
@item -ffree-line-length-@var{n} @item -ffree-line-length-@var{n}
@cindex @code{-ffree-line-length-}@var{n} option @opindex @code{ffree-line-length-}@var{n}
@cindex option, @code{-ffree-line-length-}@var{n}
@cindex source file format @cindex source file format
@cindex lines, length @cindex lines, length
@cindex length of source lines @cindex length of source lines
@cindex free form
@cindex limits, lengths of source lines @cindex limits, lengths of source lines
Set column after which characters are ignored in typical free-form Set column after which characters are ignored in typical free-form
lines in the source file. The default value is 132. lines in the source file. The default value is 132.
...@@ -283,27 +270,23 @@ lines in the source file. The default value is 132. ...@@ -283,27 +270,23 @@ lines in the source file. The default value is 132.
@option{-ffree-line-length-none}. @option{-ffree-line-length-none}.
@item -fmax-identifier-length=@var{n} @item -fmax-identifier-length=@var{n}
@cindex @code{-fmax-identifier-length=}@var{n} option @opindex @code{fmax-identifier-length=}@var{n}
@cindex option @option{-fmax-identifier-length=}@var{n}
Specify the maximum allowed identifier length. Typical values are Specify the maximum allowed identifier length. Typical values are
31 (Fortran 95) and 63 (Fortran 2003). 31 (Fortran 95) and 63 (Fortran 2003).
@item -fimplicit-none @item -fimplicit-none
@cindex @code{-fimplicit-none} option @opindex @code{fimplicit-none}
@cindex option, @code{-fimplicit-none}
Specify that no implicit typing is allowed, unless overridden by explicit Specify that no implicit typing is allowed, unless overridden by explicit
@code{IMPLICIT} statements. This is the equivalent of adding @code{IMPLICIT} statements. This is the equivalent of adding
@code{implicit none} to the start of every procedure. @code{implicit none} to the start of every procedure.
@item -fcray-pointer @item -fcray-pointer
@cindex @code{-fcray-pointer} option @opindex @code{fcray-pointer}
@cindex option, @code{-fcray-pointer}
Enable the Cray pointer extension, which provides C-like pointer Enable the Cray pointer extension, which provides C-like pointer
functionality. functionality.
@item -fopenmp @item -fopenmp
@cindex @code{-fopenmp} option @opindex @code{fopenmp}
@cindex option, @code{-fopenmp}
@cindex OpenMP @cindex OpenMP
Enable the OpenMP extensions. This includes OpenMP @code{!$omp} directives Enable the OpenMP extensions. This includes OpenMP @code{!$omp} directives
in free form in free form
...@@ -314,8 +297,7 @@ and when linking arranges for the OpenMP runtime library to be linked ...@@ -314,8 +297,7 @@ and when linking arranges for the OpenMP runtime library to be linked
in. in.
@item -frange-check @item -frange-check
@cindex @code{-frange-check} option @opindex @code{frange-check}
@cindex option, @code{-frange-check}
Enable range checking on results of simplification of constant Enable range checking on results of simplification of constant
expressions during compilation. For example, by default, GNU Fortran expressions during compilation. For example, by default, GNU Fortran
will give an overflow error at compile time when simplifying @code{a = will give an overflow error at compile time when simplifying @code{a =
...@@ -326,8 +308,7 @@ on most systems, but with @option{-fno-range-check} the value will ...@@ -326,8 +308,7 @@ on most systems, but with @option{-fno-range-check} the value will
``wrap around'' and @code{i} will be initialized to @math{-1} instead. ``wrap around'' and @code{i} will be initialized to @math{-1} instead.
@item -std=@var{std} @item -std=@var{std}
@cindex @code{-std=}@var{std} option @opindex @code{std=}@var{std} option
@cindex option, @code{-std=}@var{std}
Specify the standard to which the program is expected to conform, which Specify the standard to which the program is expected to conform, which
may be one of @samp{f95}, @samp{f2003}, @samp{gnu}, or @samp{legacy}. may be one of @samp{f95}, @samp{f2003}, @samp{gnu}, or @samp{legacy}.
The default value for @var{std} is @samp{gnu}, which specifies a The default value for @var{std} is @samp{gnu}, which specifies a
...@@ -375,8 +356,7 @@ by GNU Fortran: ...@@ -375,8 +356,7 @@ by GNU Fortran:
@table @gcctabopt @table @gcctabopt
@item -fmax-errors-@var{n} @item -fmax-errors-@var{n}
@cindex @code{-fmax-errors-}@var{n} option @opindex @code{fmax-errors-}@var{n}
@cindex option, @code{-fmax-errors-}@var{n}
@cindex errors, limiting @cindex errors, limiting
Limits the maximum number of error messages to @var{n}, at which point Limits the maximum number of error messages to @var{n}, at which point
GNU Fortran bails out rather than attempting to continue processing the GNU Fortran bails out rather than attempting to continue processing the
...@@ -384,14 +364,12 @@ source code. If @var{n} is 0, there is no limit on the number of error ...@@ -384,14 +364,12 @@ source code. If @var{n} is 0, there is no limit on the number of error
messages produced. messages produced.
@item -fsyntax-only @item -fsyntax-only
@cindex @code{-fsyntax-only} option @opindex @code{fsyntax-only}
@cindex option, @code{-fsyntax-only}
@cindex syntax checking @cindex syntax checking
Check the code for syntax errors, but don't do anything beyond that. Check the code for syntax errors, but don't do anything beyond that.
@item -pedantic @item -pedantic
@cindex @code{-pedantic} option @opindex @code{pedantic}
@cindex option, @code{-pedantic}
Issue warnings for uses of extensions to Fortran 95. Issue warnings for uses of extensions to Fortran 95.
@option{-pedantic} also applies to C-language constructs where they @option{-pedantic} also applies to C-language constructs where they
occur in GNU Fortran source files, such as use of @samp{\e} in a occur in GNU Fortran source files, such as use of @samp{\e} in a
...@@ -412,19 +390,17 @@ This should be used in conjunction with @option{-std=f95} or ...@@ -412,19 +390,17 @@ This should be used in conjunction with @option{-std=f95} or
@option{-std=f2003}. @option{-std=f2003}.
@item -pedantic-errors @item -pedantic-errors
@cindex @code{-pedantic-errors} option @opindex @code{pedantic-errors}
@cindex option, @code{-pedantic-errors}
Like @option{-pedantic}, except that errors are produced rather than Like @option{-pedantic}, except that errors are produced rather than
warnings. warnings.
@item -w @item -w
@cindex @code{-w} option @opindex @code{w}
@cindex option, @code{-w} @cindex warnings, none
Inhibit all warning messages. Inhibit all warning messages.
@item -Wall @item -Wall
@cindex @code{-Wall} option @opindex @code{Wall}
@cindex option, @code{-Wall}
@cindex all warnings @cindex all warnings
@cindex warnings, all @cindex warnings, all
Enables commonly used warning options pertaining to usage that Enables commonly used warning options pertaining to usage that
...@@ -434,9 +410,9 @@ This currently includes @option{-Waliasing}, ...@@ -434,9 +410,9 @@ This currently includes @option{-Waliasing},
@option{-Wno-tabs}, and @option{-Wline-truncation}. @option{-Wno-tabs}, and @option{-Wline-truncation}.
@item -Waliasing @item -Waliasing
@cindex @code{-Waliasing} option @opindex @code{Waliasing}
@cindex option, @code{-Waliasing}
@cindex aliasing @cindex aliasing
@cindex warnings, aliasing
Warn about possible aliasing of dummy arguments. Specifically, it warns Warn about possible aliasing of dummy arguments. Specifically, it warns
if the same actual argument is associated with a dummy argument with if the same actual argument is associated with a dummy argument with
@code{INTENT(IN)} and a dummy argument with @code{INTENT(OUT)} in a call @code{INTENT(IN)} and a dummy argument with @code{INTENT(OUT)} in a call
...@@ -456,8 +432,8 @@ The following example will trigger the warning. ...@@ -456,8 +432,8 @@ The following example will trigger the warning.
@end smallexample @end smallexample
@item -Wampersand @item -Wampersand
@cindex @code{-Wampersand} option @opindex @code{Wampersand}
@cindex option, @code{-Wampersand} @cindex warnings, ampersand
@cindex ampersand @cindex ampersand
Warn about missing ampersand in continued character constants. The warning is Warn about missing ampersand in continued character constants. The warning is
given with @option{-Wampersand}, @option{-pedantic}, @option{-std=f95}, and given with @option{-Wampersand}, @option{-pedantic}, @option{-std=f95}, and
...@@ -466,33 +442,32 @@ constant, GNU Fortran assumes continuation at the first non-comment, ...@@ -466,33 +442,32 @@ constant, GNU Fortran assumes continuation at the first non-comment,
non-whitespace character after the ampersand that initiated the continuation. non-whitespace character after the ampersand that initiated the continuation.
@item -Wcharacter-truncation @item -Wcharacter-truncation
@cindex @code{-Wcharacter-truncation} option @opindex @code{Wcharacter-truncation}
@cindex option, @code{-Wcharacter-truncation} @cindex warnings, character truncation
Warn when a character assignment will truncate the assigned string. Warn when a character assignment will truncate the assigned string.
@item -Wconversion @item -Wconversion
@cindex @code{-Wconversion} option @opindex @code{Wconversion}
@cindex option, @code{-Wconversion} @cindex warnings, conversion
@cindex conversion @cindex conversion
Warn about implicit conversions between different types. Warn about implicit conversions between different types.
@item -Wimplicit-interface @item -Wimplicit-interface
@cindex @code{-Wimplicit-interface} option @opindex @code{Wimplicit-interface}
@cindex option, @code{-Wimplicit-interface} @cindex warnings, implicit interface
Warn if a procedure is called without an explicit interface. Warn if a procedure is called without an explicit interface.
Note this only checks that an explicit interface is present. It does not Note this only checks that an explicit interface is present. It does not
check that the declared interfaces are consistent across program units. check that the declared interfaces are consistent across program units.
@item -Wnonstd-intrinsics @item -Wnonstd-intrinsics
@cindex @code{-Wnonstd-intrinsics} option @opindex @code{Wnonstd-intrinsics}
@cindex option, @code{-Wnonstd-intrinsics} @cindex warnings, non-stdandard intrinsics
Warn if the user tries to use an intrinsic that does not belong to the Warn if the user tries to use an intrinsic that does not belong to the
standard the user has chosen via the @option{-std} option. standard the user has chosen via the @option{-std} option.
@item -Wsurprising @item -Wsurprising
@cindex @code{-Wsurprising} option @opindex @code{Wsurprising}
@cindex option, @code{-Wsurprising} @cindex warnings, suspicious code
@cindex Suspicious code
Produce a warning when ``suspicious'' code constructs are encountered. Produce a warning when ``suspicious'' code constructs are encountered.
While technically legal these usually indicate that an error has been made. While technically legal these usually indicate that an error has been made.
...@@ -508,9 +483,9 @@ A LOGICAL SELECT construct has three CASE statements. ...@@ -508,9 +483,9 @@ A LOGICAL SELECT construct has three CASE statements.
@end itemize @end itemize
@item -Wtabs @item -Wtabs
@cindex @code{-Wtabs} option @opindex @code{Wtabs}
@cindex option, @code{-Wtabs} @cindex warnings, tabs
@cindex Tabs @cindex tabs
By default, tabs are accepted as whitespace, but tabs are not members By default, tabs are accepted as whitespace, but tabs are not members
of the Fortran Character Set. @option{-Wno-tabs} will cause a warning of the Fortran Character Set. @option{-Wno-tabs} will cause a warning
to be issued if a tab is encountered. Note, @option{-Wno-tabs} is active to be issued if a tab is encountered. Note, @option{-Wno-tabs} is active
...@@ -518,22 +493,21 @@ for @option{-pedantic}, @option{-std=f95}, @option{-std=f2003}, and ...@@ -518,22 +493,21 @@ for @option{-pedantic}, @option{-std=f95}, @option{-std=f2003}, and
@option{-Wall}. @option{-Wall}.
@item -Wunderflow @item -Wunderflow
@cindex @code{-Wunderflow} option @opindex @code{Wunderflow}
@cindex option, @code{-Wunderflow} @cindex warnings, underflow
@cindex UNDERFLOW @cindex underflow
Produce a warning when numerical constant expressions are Produce a warning when numerical constant expressions are
encountered, which yield an UNDERFLOW during compilation. encountered, which yield an UNDERFLOW during compilation.
@item -Werror @item -Werror
@cindex @code{-Werror} option @opindex @code{Werror}
@cindex option, @code{-Werror} @cindex warnings, to errors
Turns all warnings into errors. Turns all warnings into errors.
@item -W @item -W
@cindex @code{-W} option @opindex @code{W}
@cindex option, @code{-W}
@cindex extra warnings
@cindex warnings, extra @cindex warnings, extra
@cindex extra warnings
Turns on ``extra warnings'' and, if optimization is specified Turns on ``extra warnings'' and, if optimization is specified
via @option{-O}, the @option{-Wuninitialized} option. via @option{-O}, the @option{-Wuninitialized} option.
(This might change in future versions of GNU Fortran.) (This might change in future versions of GNU Fortran.)
...@@ -556,14 +530,12 @@ either your program or the GNU Fortran compiler. ...@@ -556,14 +530,12 @@ either your program or the GNU Fortran compiler.
@table @gcctabopt @table @gcctabopt
@item -fdump-parse-tree @item -fdump-parse-tree
@cindex @code{-fdump-parse-tree} option @opindex @code{fdump-parse-tree}
@cindex option, @code{-fdump-parse-tree}
Output the internal parse tree before starting code generation. Only Output the internal parse tree before starting code generation. Only
really useful for debugging the GNU Fortran compiler itself. really useful for debugging the GNU Fortran compiler itself.
@item -ffpe-trap=@var{list} @item -ffpe-trap=@var{list}
@cindex @code{-ffpe-trap=}@var{list} option @opindex @code{ffpe-trap=}@var{list}
@cindex option, @code{-ffpe-trap=}@var{list}
Specify a list of IEEE exceptions when a Floating Point Exception Specify a list of IEEE exceptions when a Floating Point Exception
(FPE) should be raised. On most systems, this will result in a SIGFPE (FPE) should be raised. On most systems, this will result in a SIGFPE
signal being sent and the program being interrupted, producing a core signal being sent and the program being interrupted, producing a core
...@@ -575,23 +547,20 @@ zero), @samp{overflow} (overflow in a floating point operation), ...@@ -575,23 +547,20 @@ zero), @samp{overflow} (overflow in a floating point operation),
@samp{precision} (loss of precision during operation) and @samp{denormal} @samp{precision} (loss of precision during operation) and @samp{denormal}
(operation produced a denormal value). (operation produced a denormal value).
@cindex -fbacktrace option
@cindex options, -fbacktrace
@item -fbacktrace @item -fbacktrace
@opindex @code{fbacktrace}
@cindex backtrace @cindex backtrace
@cindex trace @cindex trace
Specify that, when a runtime error is encountered, the Fortran runtime Specify that, when a runtime error is encountered, the Fortran runtime
library should output a backtrace of the error. This option library should output a backtrace of the error. This option
only has influence for compilation of the Fortran main program. only has influence for compilation of the Fortran main program.
@cindex -fdump-core option
@cindex options, -fdump-core
@item -fdump-core @item -fdump-core
@cindex core @cindex core
@cindex @code{fdump-core}
Request that a core-dump file is written to disk when a runtime error Request that a core-dump file is written to disk when a runtime error
is encountered on systems that support core dumps. This option is is encountered on systems that support core dumps. This option is
only effective for the compilation of the Fortran main program. only effective for the compilation of the Fortran main program.
@end table @end table
@xref{Debugging Options,,Options for Debugging Your Program or GCC, @xref{Debugging Options,,Options for Debugging Your Program or GCC,
...@@ -614,8 +583,7 @@ Fortran source. ...@@ -614,8 +583,7 @@ Fortran source.
@table @gcctabopt @table @gcctabopt
@item -I@var{dir} @item -I@var{dir}
@cindex @code{-I}@var{dir} option @opindex @code{I}@var{dir}
@cindex option, @code{-I}@var{dir}
@cindex directory, search paths for inclusion @cindex directory, search paths for inclusion
@cindex inclusion, directory search paths for @cindex inclusion, directory search paths for
@cindex search paths, for included files @cindex search paths, for included files
...@@ -639,10 +607,8 @@ gcc,Using the GNU Compiler Collection (GCC)}, for information on the ...@@ -639,10 +607,8 @@ gcc,Using the GNU Compiler Collection (GCC)}, for information on the
@item -M@var{dir} @item -M@var{dir}
@item -J@var{dir} @item -J@var{dir}
@cindex @code{-M}@var{dir} option @opindex @code{M}@var{dir}
@cindex option, @code{-M}@var{dir} @opindex @code{J}@var{dir}
@cindex @code{-J}@var{dir} option
@cindex option, @code{-J}@var{dir}
@cindex paths, search @cindex paths, search
@cindex module search path @cindex module search path
This option specifies where to put @file{.mod} files for compiled modules. This option specifies where to put @file{.mod} files for compiled modules.
...@@ -655,8 +621,7 @@ The default is the current directory. ...@@ -655,8 +621,7 @@ The default is the current directory.
GCC options. GCC options.
@item -fintrinsic-modules-path @var{dir} @item -fintrinsic-modules-path @var{dir}
@cindex @code{-fintrinsic-modules-path} @var{dir} option @opindex @code{fintrinsic-modules-path} @var{dir}
@cindex option, @code{-fintrinsic-modules-path}@var{dir}
@cindex paths, search @cindex paths, search
@cindex module search path @cindex module search path
This option specifies the location of pre-compiled intrinsic modules, if This option specifies the location of pre-compiled intrinsic modules, if
...@@ -670,8 +635,7 @@ they are not in the default location expected by the compiler. ...@@ -670,8 +635,7 @@ they are not in the default location expected by the compiler.
These options affect the runtime behavior of programs compiled with GNU Fortran. These options affect the runtime behavior of programs compiled with GNU Fortran.
@table @gcctabopt @table @gcctabopt
@item -fconvert=@var{conversion} @item -fconvert=@var{conversion}
@cindex @code{-fconvert=}@var{conversion} option @opindex @code{fconvert=}@var{conversion}
@cindex option, @code{-fconvert=}@var{conversion}
Specify the representation of data for unformatted files. Valid Specify the representation of data for unformatted files. Valid
values for conversion are: @samp{native}, the default; @samp{swap}, values for conversion are: @samp{native}, the default; @samp{swap},
swap between big- and little-endian; @samp{big-endian}, use big-endian swap between big- and little-endian; @samp{big-endian}, use big-endian
...@@ -683,8 +647,7 @@ The @code{CONVERT} specifier and the GFORTRAN_CONVERT_UNIT environment ...@@ -683,8 +647,7 @@ The @code{CONVERT} specifier and the GFORTRAN_CONVERT_UNIT environment
variable override the default specified by @option{-fconvert}.} variable override the default specified by @option{-fconvert}.}
@item -frecord-marker=@var{length} @item -frecord-marker=@var{length}
@cindex @code{-frecord-marker=}@var{length} option @opindex @code{frecord-marker=}@var{length}
@cindex option, @code{-frecord-marker=}@var{length}
Specify the length of record markers for unformatted files. Specify the length of record markers for unformatted files.
Valid values for @var{length} are 4 and 8. Default is 4. Valid values for @var{length} are 4 and 8. Default is 4.
@emph{This is different from previous versions of gfortran}, @emph{This is different from previous versions of gfortran},
...@@ -693,8 +656,7 @@ systems. If you want to read or write files compatible ...@@ -693,8 +656,7 @@ systems. If you want to read or write files compatible
with earlier versions of gfortran, use @option{-frecord-marker=8}. with earlier versions of gfortran, use @option{-frecord-marker=8}.
@item -fmax-subrecord-length=@var{length} @item -fmax-subrecord-length=@var{length}
@cindex @code{-fmax-subrecord-length=}@var{length} option @opindex @code{fmax-subrecord-length=}@var{length}
@cindex option, @code{-fmax-subrecord-length=}@var{length}
Specify the maximum length for a subrecord. The maximum permitted Specify the maximum length for a subrecord. The maximum permitted
value for length is 2147483639, which is also the default. Only value for length is 2147483639, which is also the default. Only
really useful for use by the gfortran testsuite. really useful for use by the gfortran testsuite.
...@@ -717,8 +679,7 @@ it. ...@@ -717,8 +679,7 @@ it.
@table @gcctabopt @table @gcctabopt
@item -fno-automatic @item -fno-automatic
@cindex @code{-fno-automatic} option @opindex @code{fno-automatic}
@cindex option, @code{-fno-automatic}
@cindex SAVE statement @cindex SAVE statement
@cindex statements, SAVE @cindex statements, SAVE
Treat each program unit as if the @code{SAVE} statement was specified for Treat each program unit as if the @code{SAVE} statement was specified for
...@@ -727,8 +688,7 @@ blocks. (Some Fortran compilers provide this option under the name ...@@ -727,8 +688,7 @@ blocks. (Some Fortran compilers provide this option under the name
@option{-static}.) @option{-static}.)
@item -ff2c @item -ff2c
@cindex @code{-ff2c} option @opindex @code{ff2c}
@cindex option, @code{-ff2c}
@cindex calling convention @cindex calling convention
@cindex @command{f2c} calling convention @cindex @command{f2c} calling convention
@cindex @command{g77} calling convention @cindex @command{g77} calling convention
...@@ -762,8 +722,7 @@ of type default @code{REAL} or @code{COMPLEX} as actual arguments, as ...@@ -762,8 +722,7 @@ of type default @code{REAL} or @code{COMPLEX} as actual arguments, as
the library implementations use the @option{-fno-f2c} calling conventions. the library implementations use the @option{-fno-f2c} calling conventions.
@item -fno-underscoring @item -fno-underscoring
@cindex @code{-fno-underscoring option} @opindex @code{fno-underscoring}
@cindex option, @code{-fno-underscoring}
@cindex underscore @cindex underscore
@cindex symbol names, underscores @cindex symbol names, underscores
@cindex transforming symbol names @cindex transforming symbol names
...@@ -833,8 +792,7 @@ prevent accidental linking between procedures with incompatible ...@@ -833,8 +792,7 @@ prevent accidental linking between procedures with incompatible
interfaces. interfaces.
@item -fsecond-underscore @item -fsecond-underscore
@cindex @code{-fsecond-underscore option} @opindex @code{fsecond-underscore}
@cindex option, @code{-fsecond-underscore}
@cindex underscore @cindex underscore
@cindex symbol names, underscores @cindex symbol names, underscores
@cindex transforming symbol names @cindex transforming symbol names
...@@ -859,8 +817,7 @@ for compatibility with @command{g77} and @command{f2c}, and is implied ...@@ -859,8 +817,7 @@ for compatibility with @command{g77} and @command{f2c}, and is implied
by use of the @option{-ff2c} option. by use of the @option{-ff2c} option.
@item -fbounds-check @item -fbounds-check
@cindex @code{-fbounds-check} option @opindex @code{fbounds-check}
@cindex option, @code{-fbounds-check}
@cindex bounds checking @cindex bounds checking
@cindex range checking @cindex range checking
@cindex array bounds checking @cindex array bounds checking
...@@ -875,8 +832,7 @@ In the future this may also include other forms of checking, e.g., checking ...@@ -875,8 +832,7 @@ In the future this may also include other forms of checking, e.g., checking
substring references. substring references.
@item -fmax-stack-var-size=@var{n} @item -fmax-stack-var-size=@var{n}
@cindex @code{-fmax-stack-var-size} option @opindex @code{fmax-stack-var-size}
@cindex option, @code{-fmax-stack-var-size}
This option specifies the size in bytes of the largest array that will be put This option specifies the size in bytes of the largest array that will be put
on the stack. on the stack.
...@@ -887,17 +843,15 @@ Future versions of GNU Fortran may improve this behavior. ...@@ -887,17 +843,15 @@ Future versions of GNU Fortran may improve this behavior.
The default value for @var{n} is 32768. The default value for @var{n} is 32768.
@item -fpack-derived @item -fpack-derived
@cindex @code{-fpack-derived} option @opindex @code{fpack-derived}
@cindex option, @code{-fpack-derived} @cindex structure packing
@cindex Structure packing
This option tells GNU Fortran to pack derived type members as closely as This option tells GNU Fortran to pack derived type members as closely as
possible. Code compiled with this option is likely to be incompatible possible. Code compiled with this option is likely to be incompatible
with code compiled without this option, and may execute slower. with code compiled without this option, and may execute slower.
@item -frepack-arrays @item -frepack-arrays
@cindex @code{-frepack-arrays} option @opindex @code{frepack-arrays}
@cindex option, @code{-frepack-arrays} @cindex repacking arrays
@cindex Repacking arrays
In some circumstances GNU Fortran may pass assumed shape array In some circumstances GNU Fortran may pass assumed shape array
sections via a descriptor describing a noncontiguous area of memory. sections via a descriptor describing a noncontiguous area of memory.
This option adds code to the function prologue to repack the data into This option adds code to the function prologue to repack the data into
...@@ -908,16 +862,14 @@ significant overhead to the function call, especially when the passed data ...@@ -908,16 +862,14 @@ significant overhead to the function call, especially when the passed data
is noncontiguous. is noncontiguous.
@item -fshort-enums @item -fshort-enums
@cindex @code{-fshort-enums} option @opindex @code{fshort-enums}
@cindex option, @code{-fshort-enums}
This option is provided for interoperability with C code that was This option is provided for interoperability with C code that was
compiled with the @option{-fshort-enums} option. It will make compiled with the @option{-fshort-enums} option. It will make
GNU Fortran choose the smallest @code{INTEGER} kind a given GNU Fortran choose the smallest @code{INTEGER} kind a given
enumerator set will fit in, and give all its enumerators this kind. enumerator set will fit in, and give all its enumerators this kind.
@item -fexternal-blas @item -fexternal-blas
@cindex @code{-fexternal-blas} option @opindex @code{fexternal-blas}
@cindex option, @code{-fexternal-blas}
This option will make gfortran generate calls to BLAS functions for some This option will make gfortran generate calls to BLAS functions for some
matrix operations like @code{MATMUL}, instead of using our own matrix operations like @code{MATMUL}, instead of using our own
algorithms, if the size of the matrices involved is larger than a given algorithms, if the size of the matrices involved is larger than a given
...@@ -926,8 +878,7 @@ optimized vendor BLAS library is available. The BLAS library will have ...@@ -926,8 +878,7 @@ optimized vendor BLAS library is available. The BLAS library will have
to be specified at link time. to be specified at link time.
@item -fblas-matmul-limit=@var{n} @item -fblas-matmul-limit=@var{n}
@cindex @code{-fblas-matmul-limit} option @opindex @code{fblas-matmul-limit}
@cindex option, @code{-fblas-matmul-limit}
Only significant when @option{-fexternal-blas} is in effect. Only significant when @option{-fexternal-blas} is in effect.
Matrix multiplication of matrices with size larger than (or equal to) @var{n} Matrix multiplication of matrices with size larger than (or equal to) @var{n}
will be performed by calls to BLAS functions, while others will be will be performed by calls to BLAS functions, while others will be
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment