Commit 40746dcc by Brooks Moses Committed by Brooks Moses

invoke.texi: Change @code-type macros to appropriate variants (@command, @option, etc.)

* invoke.texi: Change @code-type macros to appropriate
variants (@command, @option, etc.)
* gfortran.texi: Same.

From-SVN: r120420
parent ad89ea97
2007-01-03 Brooks Moses <brooks.moses@codesourcery.com> 2007-01-03 Brooks Moses <brooks.moses@codesourcery.com>
* invoke.texi: Change @code-type macros to appropriate
variants (@command, @option, etc.)
* gfortran.texi: Same.
2007-01-03 Brooks Moses <brooks.moses@codesourcery.com>
* intrinsic.texi: Various minor cleanups. * intrinsic.texi: Various minor cleanups.
2007-01-02 Steven G. Kargl <kargls@comcast.net> 2007-01-02 Steven G. Kargl <kargls@comcast.net>
......
...@@ -618,7 +618,7 @@ be sure to quote spaces, as in ...@@ -618,7 +618,7 @@ be sure to quote spaces, as in
@smallexample @smallexample
$ GFORTRAN_LIST_SEPARATOR=' , ' ./a.out $ GFORTRAN_LIST_SEPARATOR=' , ' ./a.out
@end smallexample @end smallexample
when @code{a.out} is the compiled Fortran program that you want to run. when @command{a.out} is the compiled Fortran program that you want to run.
Default is a single space. Default is a single space.
@node GFORTRAN_CONVERT_UNIT @node GFORTRAN_CONVERT_UNIT
...@@ -648,7 +648,7 @@ the modes are the same as for the @code{CONVERT} specifier: ...@@ -648,7 +648,7 @@ the modes are the same as for the @code{CONVERT} specifier:
@item @code{BIG_ENDIAN} Use the big-endian format for unformatted files. @item @code{BIG_ENDIAN} Use the big-endian format for unformatted files.
@end itemize @end itemize
A missing mode for an exception is taken to mean @code{BIG_ENDIAN}. A missing mode for an exception is taken to mean @code{BIG_ENDIAN}.
Examples of values for @code{GFORTRAN_CONVERT_UNIT} are: Examples of values for @env{GFORTRAN_CONVERT_UNIT} are:
@itemize @w{} @itemize @w{}
@item @code{'big_endian'} Do all unformatted I/O in big_endian mode. @item @code{'big_endian'} Do all unformatted I/O in big_endian mode.
@item @code{'little_endian;native:10-20,25'} Do all unformatted I/O @item @code{'little_endian;native:10-20,25'} Do all unformatted I/O
...@@ -658,17 +658,17 @@ native format. ...@@ -658,17 +658,17 @@ native format.
@end itemize @end itemize
Setting the environment variables should be done on the command Setting the environment variables should be done on the command
line or via the @code{export} line or via the @command{export}
command for @code{sh}-compatible shells and via @code{setenv} command for @command{sh}-compatible shells and via @command{setenv}
for @code{csh}-compatible shells. for @command{csh}-compatible shells.
Example for @code{sh}: Example for @command{sh}:
@smallexample @smallexample
$ gfortran foo.f90 $ gfortran foo.f90
$ GFORTRAN_CONVERT_UNIT='big_endian;native:10-20' ./a.out $ GFORTRAN_CONVERT_UNIT='big_endian;native:10-20' ./a.out
@end smallexample @end smallexample
Example code for @code{csh}: Example code for @command{csh}:
@smallexample @smallexample
% gfortran foo.f90 % gfortran foo.f90
% setenv GFORTRAN_CONVERT_UNIT 'big_endian;native:10-20' % setenv GFORTRAN_CONVERT_UNIT 'big_endian;native:10-20'
...@@ -683,7 +683,7 @@ portable. ...@@ -683,7 +683,7 @@ portable.
@xref{CONVERT specifier}, for an alternative way to specify the @xref{CONVERT specifier}, for an alternative way to specify the
data representation for unformatted files. @xref{Runtime Options}, for data representation for unformatted files. @xref{Runtime Options}, for
setting a default data representation for the whole program. The setting a default data representation for the whole program. The
@code{CONVERT} specifier overrides the @code{-fconvert} compile options. @code{CONVERT} specifier overrides the @option{-fconvert} compile options.
@c ===================================================================== @c =====================================================================
...@@ -1261,12 +1261,12 @@ portable. ...@@ -1261,12 +1261,12 @@ portable.
@cindex OpenMP @cindex OpenMP
GNU Fortran attempts to be OpenMP Application Program Interface v2.5 GNU Fortran attempts to be OpenMP Application Program Interface v2.5
compatible when invoked with the @code{-fopenmp} option. GNU Fortran compatible when invoked with the @option{-fopenmp} option. GNU Fortran
then generates parallelized code according to the OpenMP directives then generates parallelized code according to the OpenMP directives
used in the source. The OpenMP Fortran runtime library used in the source. The OpenMP Fortran runtime library
routines are provided both in a form of Fortran 90 module named routines are provided both in a form of a Fortran 90 module named
@code{omp_lib} and in a form of a Fortran @code{include} file named @code{omp_lib} and in a form of a Fortran @code{include} file named
@code{omp_lib.h}. @file{omp_lib.h}.
For details refer to the actual For details refer to the actual
@uref{http://www.openmp.org/drupal/mp-documents/spec25.pdf, @uref{http://www.openmp.org/drupal/mp-documents/spec25.pdf,
......
...@@ -289,8 +289,8 @@ Specify the maximum allowed identifier length. Typical values are ...@@ -289,8 +289,8 @@ Specify the maximum allowed identifier length. Typical values are
@cindex options, -fimplicit-none @cindex options, -fimplicit-none
@item -fimplicit-none @item -fimplicit-none
Specify that no implicit typing is allowed, unless overridden by explicit Specify that no implicit typing is allowed, unless overridden by explicit
@samp{IMPLICIT} statements. This is the equivalent of adding @code{IMPLICIT} statements. This is the equivalent of adding
@samp{implicit none} to the start of every procedure. @code{implicit none} to the start of every procedure.
@cindex -fcray-pointer option @cindex -fcray-pointer option
@cindex options, -fcray-pointer @cindex options, -fcray-pointer
...@@ -312,14 +312,14 @@ in. ...@@ -312,14 +312,14 @@ in.
@cindex -frange-check @cindex -frange-check
@cindex options, -frange-check @cindex options, -frange-check
@item -frange-check @item -frange-check
Enable range checking on results of simplification of constant expressions Enable range checking on results of simplification of constant
during compilation. For example, by default, GNU Fortran will give expressions during compilation. For example, by default, GNU Fortran
an overflow error at compile time when simplifying @code{a = EXP(1000)}. will give an overflow error at compile time when simplifying @code{a =
With @samp{-fno-range-check}, no error will be given and the variable @code{a} EXP(1000)}. With @option{-fno-range-check}, no error will be given and
will be assigned the value @code{+Infinity}. Similarly, the variable @code{a} will be assigned the value @code{+Infinity}.
@code{DATA i/Z'FFFFFFFF'/} will result in an integer overflow on most systems, Similarly, @code{DATA i/Z'FFFFFFFF'/} will result in an integer overflow
but with @samp{-fno-range-check} the value will ``wrap around'' and @code{i} on most systems, but with @option{-fno-range-check} the value will
will be initialized to @math{-1} instead. ``wrap around'' and @code{i} will be initialized to @math{-1} instead.
@cindex -std=@var{std} option @cindex -std=@var{std} option
@cindex option, -std=@var{std} @cindex option, -std=@var{std}
...@@ -384,7 +384,7 @@ Check the code for syntax errors, but don't do anything beyond that. ...@@ -384,7 +384,7 @@ Check the code for syntax errors, but don't do anything beyond that.
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
character constant within a directive like @samp{#include}. character constant within a directive like @code{#include}.
Valid Fortran 95 programs should compile properly with or without Valid Fortran 95 programs should compile properly with or without
this option. this option.
...@@ -429,7 +429,7 @@ This currently includes @option{-Waliasing}, ...@@ -429,7 +429,7 @@ This currently includes @option{-Waliasing},
@cindex aliasing @cindex 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
with an explicit interface. with an explicit interface.
The following example will trigger the warning. The following example will trigger the warning.
...@@ -564,7 +564,7 @@ Specify a list of IEEE exceptions when a Floating Point Exception ...@@ -564,7 +564,7 @@ Specify a list of IEEE exceptions when a Floating Point Exception
signal being sent and the program being interrupted, producing a core signal being sent and the program being interrupted, producing a core
file useful for debugging. @var{list} is a (possibly empty) comma-separated file useful for debugging. @var{list} is a (possibly empty) comma-separated
list of the following IEEE exceptions: @samp{invalid} (invalid floating list of the following IEEE exceptions: @samp{invalid} (invalid floating
point operation, such as @code{sqrt(-1.0)}), @samp{zero} (division by point operation, such as @code{SQRT(-1.0)}), @samp{zero} (division by
zero), @samp{overflow} (overflow in a floating point operation), zero), @samp{overflow} (overflow in a floating point operation),
@samp{underflow} (underflow in a floating point operation), @samp{underflow} (underflow 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}
...@@ -608,7 +608,7 @@ Also note that the general behavior of @option{-I} and ...@@ -608,7 +608,7 @@ Also note that the general behavior of @option{-I} and
@code{#include} in the @command{cpp} preprocessor, with regard to @code{#include} in the @command{cpp} preprocessor, with regard to
looking for @file{header.gcc} files and other such things. looking for @file{header.gcc} files and other such things.
This path is also used to search for @samp{.mod} files when previously This path is also used to search for @file{.mod} files when previously
compiled modules are required by a @code{USE} statement. compiled modules are required by a @code{USE} statement.
@xref{Directory Options,,Options for Directory Search, @xref{Directory Options,,Options for Directory Search,
...@@ -619,7 +619,7 @@ gcc,Using the GNU Compiler Collection (GCC)}, for information on the ...@@ -619,7 +619,7 @@ gcc,Using the GNU Compiler Collection (GCC)}, for information on the
@cindex option, -Mdir @cindex option, -Mdir
@item -M@var{dir} @item -M@var{dir}
@item -J@var{dir} @item -J@var{dir}
This option specifies where to put @samp{.mod} files for compiled modules. This option specifies where to put @file{.mod} files for compiled modules.
It is also added to the list of directories to searched by an @code{USE} It is also added to the list of directories to searched by an @code{USE}
statement. statement.
...@@ -645,7 +645,7 @@ representation for unformatted files. ...@@ -645,7 +645,7 @@ representation for unformatted files.
@emph{This option has an effect only when used in the main program. @emph{This option has an effect only when used in the main program.
The @code{CONVERT} specifier and the GFORTRAN_CONVERT_UNIT environment The @code{CONVERT} specifier and the GFORTRAN_CONVERT_UNIT environment
variable override the default specified by -fconvert.} variable override the default specified by @option{-fconvert}.}
@cindex -frecord-marker=@var{length} @cindex -frecord-marker=@var{length}
@item -frecord-marker=@var{length} @item -frecord-marker=@var{length}
...@@ -654,7 +654,7 @@ Valid values for @var{length} are 4 and 8. Default is 4. ...@@ -654,7 +654,7 @@ 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},
which specified a default record marker length of 8 on most which specified a default record marker length of 8 on most
systems. If you want to read or write files compatible systems. If you want to read or write files compatible
with earlier versions of gfortran, use @samp{-frecord-marker=8}. with earlier versions of gfortran, use @option{-frecord-marker=8}.
@cindex -fmax-subrecord-length=@var{length} @cindex -fmax-subrecord-length=@var{length}
@item -fmax-subrecord-length=@var{length} @item -fmax-subrecord-length=@var{length}
...@@ -714,15 +714,15 @@ option, unless @option{-fno-second-underscore} is explicitly requested. ...@@ -714,15 +714,15 @@ option, unless @option{-fno-second-underscore} is explicitly requested.
This does not affect the generation of code that interfaces with This does not affect the generation of code that interfaces with
the @command{libgfortran} library. the @command{libgfortran} library.
@emph{Caution:} It is not a good idea to mix Fortran code compiled @emph{Caution:} It is not a good idea to mix Fortran code compiled with
with @code{-ff2c} with code compiled with the default @code{-fno-f2c} @option{-ff2c} with code compiled with the default @option{-fno-f2c}
calling conventions as, calling @code{COMPLEX} or default @code{REAL} calling conventions as, calling @code{COMPLEX} or default @code{REAL}
functions between program parts which were compiled with different functions between program parts which were compiled with different
calling conventions will break at execution time. calling conventions will break at execution time.
@emph{Caution:} This will break code which passes intrinsic functions @emph{Caution:} This will break code which passes intrinsic functions
of type default @code{REAL} or @code{COMPLEX} as actual arguments, as of type default @code{REAL} or @code{COMPLEX} as actual arguments, as
the library implementations use the @command{-fno-f2c} calling conventions. the library implementations use the @option{-fno-f2c} calling conventions.
@cindex @option{-fno-underscoring option} @cindex @option{-fno-underscoring option}
@cindex options, @option{-fno-underscoring} @cindex options, @option{-fno-underscoring}
...@@ -750,17 +750,14 @@ existing system environments (vis-a-vis existing libraries, tools, and ...@@ -750,17 +750,14 @@ existing system environments (vis-a-vis existing libraries, tools, and
so on). so on).
For example, with @option{-funderscoring}, and assuming other defaults like For example, with @option{-funderscoring}, and assuming other defaults like
@option{-fcase-lower} and that @samp{j()} and @samp{max_count()} are @option{-fcase-lower} and that @code{j()} and @code{max_count()} are
external functions while @samp{my_var} and @samp{lvar} are local variables, external functions while @code{my_var} and @code{lvar} are local variables,
a statement like a statement like
@smallexample @smallexample
I = J() + MAX_COUNT (MY_VAR, LVAR) I = J() + MAX_COUNT (MY_VAR, LVAR)
@end smallexample @end smallexample
@noindent @noindent
is implemented as something akin to: is implemented as something akin to:
@smallexample @smallexample
i = j_() + max_count__(&my_var__, &lvar); i = j_() + max_count__(&my_var__, &lvar);
@end smallexample @end smallexample
...@@ -818,9 +815,9 @@ names. ...@@ -818,9 +815,9 @@ names.
This option has no effect if @option{-fno-underscoring} is This option has no effect if @option{-fno-underscoring} is
in effect. It is implied by the @option{-ff2c} option. in effect. It is implied by the @option{-ff2c} option.
Otherwise, with this option, an external name such as @samp{MAX_COUNT} Otherwise, with this option, an external name such as @code{MAX_COUNT}
is implemented as a reference to the link-time external symbol is implemented as a reference to the link-time external symbol
@samp{max_count__}, instead of @samp{max_count_}. This is required @code{max_count__}, instead of @code{max_count_}. This is required
for compatibility with @command{g77} and @command{f2c}, and is implied 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.
......
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