Commit a2bef74c by Daniel Franke Committed by Daniel Franke

invoke.texi: Unified upper- and lower-case in menus.

2007-07-13  Daniel Franke  <franke.daniel@gmail.com>

        * invoke.texi: Unified upper- and lower-case in menus.
        (-w, -W): Removed, documented by gcc.
        * intrinsic.texi: Unified Class-section entries, added
        subroutine/function warning where appropiate.

From-SVN: r126614
parent 1617e5ee
2007-07-13 Daniel Franke <franke.daniel@gmail.com>
* invoke.texi: Unified upper- and lower-case in menus.
(-w, -W): Removed, documented by gcc.
* intrinsic.texi: Unified Class-section entries, added
subroutine/function warning where appropiate.
2007-07-12 Daniel Franke <franke.daniel@gmail.com>
PR fortran/31639
......
......@@ -314,7 +314,7 @@ which is suitable for debugging purposes.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine
@item @emph{Syntax}:
@code{CALL ABORT}
......@@ -876,7 +876,7 @@ in the array along dimension @var{DIM}.
F95 and later
@item @emph{Class}:
transformational function
Transformational function
@item @emph{Syntax}:
@code{RESULT = ALL(MASK [, DIM])}
......@@ -986,7 +986,7 @@ the use of the @ref{IAND} intrinsic defined by the Fortran standard.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = AND(I, J)}
......@@ -1090,7 +1090,7 @@ end program test_anint
F95 and later
@item @emph{Class}:
transformational function
Transformational function
@item @emph{Syntax}:
@code{RESULT = ANY(MASK [, DIM])}
......@@ -2221,7 +2221,7 @@ only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -2273,7 +2273,7 @@ only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -2310,7 +2310,7 @@ program chmod_test
print *, 'Status: ', status
end program chmod_test
@end smallexample
@code{CHMOD} as non-elemental function:
@code{CHMOD} as function:
@smallexample
program chmod_test
implicit none
......@@ -2652,7 +2652,7 @@ range of @math{1 /leq DIM /leq n)} where @math{n} is the rank of @var{MASK}.
F95 and later
@item @emph{Class}:
transformational function
Transformational function
@item @emph{Syntax}:
@code{RESULT = COUNT(MASK [, DIM])}
......@@ -2814,7 +2814,7 @@ only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -3172,7 +3172,7 @@ vectors are @code{LOGICAL}, the result is @code{ANY(X.AND.Y)}.
F95 and later
@item @emph{Class}:
transformational function
Transformational function
@item @emph{Syntax}:
@code{RESULT = DOT_PRODUCT(X, Y)}
......@@ -3310,8 +3310,8 @@ sufficiently small limits that overflows (wrap around) are possible, such as
become, negative, or numerically less than previous values, during a single
run of the compiled program.
If @code{DTIME} is invoked as a function, it can not be invoked as a
subroutine, and vice versa.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@var{TARRAY} and @var{RESULT} are @code{INTENT(OUT)} and provide the following:
......@@ -3325,7 +3325,7 @@ subroutine, and vice versa.
GNU extension
@item @emph{Class}:
Subroutine
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -3575,8 +3575,8 @@ sufficiently small limits that overflows (wrap around) are possible, such as
become, negative, or numerically less than previous values, during a single
run of the compiled program.
If @code{ETIME} is invoked as a function, it can not be invoked as a
subroutine, and vice versa.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@var{TARRAY} and @var{RESULT} are @code{INTENT(OUT)} and provide the following:
......@@ -3590,7 +3590,7 @@ subroutine, and vice versa.
GNU extension
@item @emph{Class}:
Subroutine
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -3786,8 +3786,8 @@ end program test_exponent
@code{CTIME}) in @var{DATE}. It is equivalent to @code{CALL CTIME(DATE,
TIME())}.
If @code{FDATE} is invoked as a function, it can not be invoked as a
subroutine, and vice versa.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@var{DATE} is an @code{INTENT(OUT)} @code{CHARACTER} variable.
......@@ -3795,7 +3795,7 @@ subroutine, and vice versa.
GNU extension
@item @emph{Class}:
Subroutine
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -3882,7 +3882,10 @@ Read a single character in stream mode from stdin by bypassing normal
formatted output. Stream I/O should not be mixed with normal record-oriented
(formatted or unformatted) I/O on the same unit; the results are unpredictable.
This intrinsic routine is provided for backwards compatibility with
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
Note that the @code{FGET} intrinsic is provided for backwards compatibility with
@command{g77}. GNU Fortran provides the Fortran 2003 Stream facility.
Programmers should consider the use of new stream IO feature in new code
for future portability. See also @ref{Fortran 2003 status}.
......@@ -3891,7 +3894,7 @@ for future portability. See also @ref{Fortran 2003 status}.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL FGET(C [, STATUS])}
......@@ -3940,8 +3943,11 @@ Read a single character in stream mode by bypassing normal formatted output.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
This intrinsic routine is provided for backwards compatibility with
@command{g77}. GNU Fortran provides the Fortran 2003 Stream facility.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
Note that the @code{FGET} intrinsic is provided for backwards compatibility
with @command{g77}. GNU Fortran provides the Fortran 2003 Stream facility.
Programmers should consider the use of new stream IO feature in new code
for future portability. See also @ref{Fortran 2003 status}.
......@@ -3949,7 +3955,7 @@ for future portability. See also @ref{Fortran 2003 status}.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL FGETC(UNIT, C [, STATUS])}
......@@ -4045,7 +4051,7 @@ argument, all units are flushed, otherwise just the unit specified.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine
@item @emph{Syntax}:
@code{CALL FLUSH(UNIT)}
......@@ -4077,7 +4083,7 @@ open Fortran I/O unit @code{UNIT}.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = FNUM(UNIT)}
......@@ -4117,7 +4123,10 @@ Write a single character in stream mode to stdout by bypassing normal
formatted output. Stream I/O should not be mixed with normal record-oriented
(formatted or unformatted) I/O on the same unit; the results are unpredictable.
This intrinsic routine is provided for backwards compatibility with
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
Note that the @code{FGET} intrinsic is provided for backwards compatibility with
@command{g77}. GNU Fortran provides the Fortran 2003 Stream facility.
Programmers should consider the use of new stream IO feature in new code
for future portability. See also @ref{Fortran 2003 status}.
......@@ -4126,7 +4135,7 @@ for future portability. See also @ref{Fortran 2003 status}.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL FPUT(C [, STATUS])}
......@@ -4168,7 +4177,10 @@ Write a single character in stream mode by bypassing normal formatted
output. Stream I/O should not be mixed with normal record-oriented
(formatted or unformatted) I/O on the same unit; the results are unpredictable.
This intrinsic routine is provided for backwards compatibility with
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
Note that the @code{FGET} intrinsic is provided for backwards compatibility with
@command{g77}. GNU Fortran provides the Fortran 2003 Stream facility.
Programmers should consider the use of new stream IO feature in new code
for future portability. See also @ref{Fortran 2003 status}.
......@@ -4177,7 +4189,7 @@ for future portability. See also @ref{Fortran 2003 status}.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL FPUTC(UNIT, C [, STATUS])}
......@@ -4386,11 +4398,14 @@ already opened file is obtained.
The elements in @code{BUFF} are the same as described by @ref{STAT}.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@item @emph{Standard}:
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL FSTAT(UNIT, BUFF [, STATUS])}
......@@ -4671,11 +4686,14 @@ END PROGRAM
@item @emph{Description}:
Get current working directory.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@item @emph{Standard}:
GNU extension
@item @emph{Class}:
Non-elemental subroutine.
Subroutine, function
@item @emph{Syntax}:
@code{CALL GETCWD(CWD [, STATUS])}
......@@ -4805,7 +4823,7 @@ Returns the numerical group ID of the current process.
GNU extension
@item @emph{Class}:
function
Function
@item @emph{Syntax}:
@code{RESULT = GETGID()}
......@@ -4883,7 +4901,7 @@ Returns the numerical process identifier of the current process.
GNU extension
@item @emph{Class}:
function
Function
@item @emph{Syntax}:
@code{RESULT = GETPID()}
......@@ -4922,7 +4940,7 @@ Returns the numerical user ID of the current process.
GNU extension
@item @emph{Class}:
function
Function
@item @emph{Syntax}:
@code{RESULT = GETUID()}
......@@ -5192,7 +5210,7 @@ standard.
GNU extension
@item @emph{Class}:
Non-elemental Function
Function
@item @emph{Syntax}:
@code{RESULT = IARGC()}
......@@ -5494,7 +5512,7 @@ function.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = IERRNO()}
......@@ -5750,7 +5768,7 @@ it is used as a new seed with @code{SRAND}.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = IRAND(FLAG)}
......@@ -5791,7 +5809,7 @@ Determine whether a unit is connected to a terminal device.
GNU extension.
@item @emph{Class}:
Non-elemental function.
Function
@item @emph{Syntax}:
@code{RESULT = ISATTY(UNIT)}
......@@ -5960,8 +5978,11 @@ end program test_itime
Sends the signal specified by @var{SIGNAL} to the process @var{PID}.
See @code{kill(2)}.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@item @emph{Class}:
Subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL KILL(PID, SIGNAL [, STATUS])}
......@@ -6247,7 +6268,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -6668,11 +6689,14 @@ then the link itself is statted, not the file that it refers to.
The elements in @code{BUFF} are the same as described by @ref{STAT}.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@item @emph{Standard}:
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL LSTAT(FILE, BUFF [, STATUS])}
......@@ -6765,7 +6789,7 @@ using Fortran 95 pointers, the memory allocation intrinsic is
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{PTR = MALLOC(SIZE)}
......@@ -7088,7 +7112,7 @@ compiled program.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = MCLOCK()}
......@@ -7128,7 +7152,7 @@ less than previous values during a single run of the compiled program.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = MCLOCK8()}
......@@ -7825,7 +7849,7 @@ the use of the @ref{IOR} intrinsic defined by the Fortran standard.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = OR(X, Y)}
......@@ -8155,7 +8179,7 @@ documentation.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{See also}:
@ref{RAND}, @ref{RANDOM_NUMBER}
......@@ -8180,7 +8204,7 @@ it is used as a new seed with @code{SRAND}.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = RAND(FLAG)}
......@@ -8443,7 +8467,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -8747,7 +8771,7 @@ use is discouraged.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = SECNDS (X)}
......@@ -8798,7 +8822,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -9096,7 +9120,7 @@ is supplied, it is set to the value returned by @code{signal(2)}.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -9559,7 +9583,7 @@ generator is specified by the required argument @var{SEED}.
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine
@item @emph{Syntax}:
@code{CALL SRAND(SEED)}
......@@ -9622,12 +9646,14 @@ The elements that are obtained and stored in the array @code{BUFF}:
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
This intrinsic is provided in both subroutine and function forms; however,
only one form can be used in any given program unit.
@item @emph{Standard}:
GNU extension
@item @emph{Class}:
Non-elemental subroutine
Subroutine, function
@item @emph{Syntax}:
@code{CALL STAT(FILE,BUFF[,STATUS])}
......@@ -9752,7 +9778,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -9794,7 +9820,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -9990,7 +10016,7 @@ compilers.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = TIME()}
......@@ -10029,7 +10055,7 @@ less than previous values during a single run of the compiled program.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = TIME8()}
......@@ -10232,7 +10258,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -10351,7 +10377,7 @@ however, only one form can be used in any given program unit.
GNU extension
@item @emph{Class}:
Subroutine, non-elemental function
Subroutine, function
@item @emph{Syntax}:
@multitable @columnfractions .80
......@@ -10492,7 +10518,7 @@ the use of the @ref{IEOR} intrinsic defined by the Fortran standard.
GNU extension
@item @emph{Class}:
Non-elemental function
Function
@item @emph{Syntax}:
@code{RESULT = XOR(X, Y)}
......
......@@ -101,11 +101,11 @@ one is not the default.
* Runtime Options:: Influencing runtime behavior
* Code Gen Options:: Specifying conventions for function calls, data layout
and register usage.
* Environment Variables:: Env vars that affect @command{gfortran}.
* Environment Variables:: Environment variables that affect @command{gfortran}.
@end menu
@node Option Summary
@section Option Summary
@section Option summary
@c man begin OPTIONS
......@@ -114,7 +114,7 @@ by type. Explanations are in the following sections.
@table @emph
@item Fortran Language Options
@xref{Fortran Dialect Options,,Options Controlling Fortran Dialect}.
@xref{Fortran Dialect Options,,Options controlling Fortran dialect}.
@gccoptlist{-fall-intrinsics -ffree-form -fno-fixed-form @gol
-fdollar-ok -fimplicit-none -fmax-identifier-length @gol
-std=@var{std} -fd-lines-as-code -fd-lines-as-comments @gol
......@@ -124,21 +124,21 @@ by type. Explanations are in the following sections.
-fcray-pointer -fopenmp -frange-check -fno-backslash }
@item Error and Warning Options
@xref{Error and Warning Options,,Options to Request or Suppress Errors
and Warnings}.
@xref{Error and Warning Options,,Options to request or suppress errors
and warnings}.
@gccoptlist{-fmax-errors=@var{n} @gol
-fsyntax-only -pedantic -pedantic-errors @gol
-w -Wall -Waliasing -Wampersand -Wcharacter-truncation -Wconversion @gol
-Wimplicit-interface -Wline-truncation -Wnonstd-intrinsics -Wsurprising @gol
-Wno-tabs -Wunderflow -W}
-Wno-tabs -Wunderflow}
@item Debugging Options
@xref{Debugging Options,,Options for Debugging Your Program or GCC}.
@xref{Debugging Options,,Options for debugging your program or GNU Fortran}.
@gccoptlist{-fdump-parse-tree -ffpe-trap=@var{list} @gol
-fdump-core -fbacktrace}
@item Directory Options
@xref{Directory Options,,Options for Directory Search}.
@xref{Directory Options,,Options for directory search}.
@gccoptlist{-I@var{dir} -J@var{dir} -M@var{dir} -fintrinsic-modules-path @var{dir}}
@item Link Options
......@@ -151,7 +151,7 @@ and Warnings}.
-fmax-subrecord-length=@var{length}}
@item Code Generation Options
@xref{Code Gen Options,,Options for Code Generation Conventions}.
@xref{Code Gen Options,,Options for code generation conventions}.
@gccoptlist{-fno-automatic -ff2c -fno-underscoring
-fsecond-underscore @gol
-fbounds-check -fmax-stack-var-size=@var{n} @gol
......@@ -172,7 +172,7 @@ and Warnings}.
@end menu
@node Fortran Dialect Options
@section Options Controlling Fortran Dialect
@section Options controlling Fortran dialect
@cindex dialect options
@cindex language, dialect options
@cindex options, dialect
......@@ -320,7 +320,7 @@ standards.
@end table
@node Error and Warning Options
@section Options to Request or Suppress Errors and Warnings
@section Options to request or suppress errors and warnings
@cindex options, warnings
@cindex options, errors
@cindex warnings, suppressing
......@@ -388,11 +388,6 @@ This should be used in conjunction with @option{-std=f95} or
Like @option{-pedantic}, except that errors are produced rather than
warnings.
@item -w
@opindex @code{w}
@cindex warnings, none
Inhibit all warning messages.
@item -Wall
@opindex @code{Wall}
@cindex all warnings
......@@ -497,14 +492,6 @@ encountered, which yield an UNDERFLOW during compilation.
@opindex @code{Werror}
@cindex warnings, to errors
Turns all warnings into errors.
@item -W
@opindex @code{W}
@cindex warnings, extra
@cindex extra warnings
Turns on ``extra warnings'' and, if optimization is specified
via @option{-O}, the @option{-Wuninitialized} option.
(This might change in future versions of GNU Fortran.)
@end table
@xref{Error and Warning Options,,Options to Request or Suppress Errors and
......@@ -515,7 +502,7 @@ and other GNU compilers.
Some of these have no effect when compiling programs written in Fortran.
@node Debugging Options
@section Options for Debugging Your Program or GNU Fortran
@section Options for debugging your program or GNU Fortran
@cindex options, debugging
@cindex debugging information options
......@@ -562,7 +549,7 @@ gcc,Using the GNU Compiler Collection (GCC)}, for more information on
debugging options.
@node Directory Options
@section Options for Directory Search
@section Options for directory search
@cindex directory, options
@cindex options, directory search
@cindex search path
......@@ -623,7 +610,7 @@ they are not in the default location expected by the compiler.
@end table
@node Link Options
@section Influencing the Linking Step
@section Influencing the linking step
@cindex options, linking
@cindex linking, static
......@@ -642,7 +629,7 @@ configured, this option has no effect.
@node Runtime Options
@section Influencing Runtime Behavior
@section Influencing runtime behavior
@cindex options, runtime
These options affect the runtime behavior of programs compiled with GNU Fortran.
......@@ -663,10 +650,10 @@ variable override the default specified by @option{-fconvert}.}
@opindex @code{frecord-marker=}@var{length}
Specify the length of record markers for unformatted files.
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 @command{gfortran}},
which specified a default record marker length of 8 on most
systems. If you want to read or write files compatible
with earlier versions of gfortran, use @option{-frecord-marker=8}.
with earlier versions of @command{gfortran}, use @option{-frecord-marker=8}.
@item -fmax-subrecord-length=@var{length}
@opindex @code{fmax-subrecord-length=}@var{length}
......@@ -676,7 +663,7 @@ really useful for use by the gfortran testsuite.
@end table
@node Code Gen Options
@section Options for Code Generation Conventions
@section Options for code generation conventions
@cindex code generation, conventions
@cindex options, code generation
@cindex options, run-time
......@@ -883,8 +870,8 @@ enumerator set will fit in, and give all its enumerators this kind.
@item -fexternal-blas
@opindex @code{fexternal-blas}
This option will make gfortran generate calls to BLAS functions for some
matrix operations like @code{MATMUL}, instead of using our own
This option will make @command{gfortran} generate calls to BLAS functions
for some matrix operations like @code{MATMUL}, instead of using our own
algorithms, if the size of the matrices involved is larger than a given
limit (see @option{-fblas-matmul-limit}). This may be profitable if an
optimized vendor BLAS library is available. The BLAS library will have
......@@ -912,7 +899,7 @@ shared by @command{gfortran}, @command{gcc}, and other GNU compilers.
@c man end
@node Environment Variables
@section Environment Variables Affecting @command{gfortran}
@section Environment variables affecting @command{gfortran}
@cindex environment variable
@c man begin ENVIRONMENT
......
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