variants (@command, @option, etc.)
* gfortran.texi: Same.
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@120420
138bc75d-0d04-0410-961f-
82ee72b054a4
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.
2007-01-02 Steven G. Kargl <kargls@comcast.net>
* intrinsic.texi: Various minor cleanups.
2007-01-02 Steven G. Kargl <kargls@comcast.net>
@smallexample
$ GFORTRAN_LIST_SEPARATOR=' , ' ./a.out
@end smallexample
@smallexample
$ GFORTRAN_LIST_SEPARATOR=' , ' ./a.out
@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.
@node GFORTRAN_CONVERT_UNIT
Default is a single space.
@node GFORTRAN_CONVERT_UNIT
@item @code{BIG_ENDIAN} Use the big-endian format for unformatted files.
@end itemize
A missing mode for an exception is taken to mean @code{BIG_ENDIAN}.
@item @code{BIG_ENDIAN} Use the big-endian format for unformatted files.
@end itemize
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{}
@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
@itemize @w{}
@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
@end itemize
Setting the environment variables should be done on the command
@end itemize
Setting the environment variables should be done on the command
-line or via the @code{export}
-command for @code{sh}-compatible shells and via @code{setenv}
-for @code{csh}-compatible shells.
+line or via the @command{export}
+command for @command{sh}-compatible shells and via @command{setenv}
+for @command{csh}-compatible shells.
+Example for @command{sh}:
@smallexample
$ gfortran foo.f90
$ GFORTRAN_CONVERT_UNIT='big_endian;native:10-20' ./a.out
@end smallexample
@smallexample
$ gfortran foo.f90
$ GFORTRAN_CONVERT_UNIT='big_endian;native:10-20' ./a.out
@end smallexample
-Example code for @code{csh}:
+Example code for @command{csh}:
@smallexample
% gfortran foo.f90
% setenv GFORTRAN_CONVERT_UNIT 'big_endian;native:10-20'
@smallexample
% gfortran foo.f90
% setenv GFORTRAN_CONVERT_UNIT 'big_endian;native:10-20'
@xref{CONVERT specifier}, for an alternative way to specify the
data representation for unformatted files. @xref{Runtime Options}, for
setting a default data representation for the whole program. The
@xref{CONVERT specifier}, for an alternative way to specify the
data representation for unformatted files. @xref{Runtime Options}, for
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 =====================================================================
@cindex OpenMP
GNU Fortran attempts to be OpenMP Application Program Interface v2.5
@cindex OpenMP
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
used in the source. The OpenMP Fortran runtime library
then generates parallelized code according to the OpenMP directives
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
For details refer to the actual
@uref{http://www.openmp.org/drupal/mp-documents/spec25.pdf,
For details refer to the actual
@uref{http://www.openmp.org/drupal/mp-documents/spec25.pdf,
@cindex options, -fimplicit-none
@item -fimplicit-none
Specify that no implicit typing is allowed, unless overridden by explicit
@cindex options, -fimplicit-none
@item -fimplicit-none
Specify that no implicit typing is allowed, unless overridden by explicit
-@samp{IMPLICIT} statements. This is the equivalent of adding
-@samp{implicit none} to the start of every procedure.
+@code{IMPLICIT} statements. This is the equivalent of adding
+@code{implicit none} to the start of every procedure.
@cindex -fcray-pointer option
@cindex options, -fcray-pointer
@cindex -fcray-pointer option
@cindex options, -fcray-pointer
@cindex -frange-check
@cindex options, -frange-check
@item -frange-check
@cindex -frange-check
@cindex options, -frange-check
@item -frange-check
-Enable range checking on results of simplification of constant expressions
-during compilation. For example, by default, GNU Fortran will give
-an overflow error at compile time when simplifying @code{a = EXP(1000)}.
-With @samp{-fno-range-check}, no error will be given and the variable @code{a}
-will be assigned the value @code{+Infinity}. Similarly,
-@code{DATA i/Z'FFFFFFFF'/} will result in an integer overflow on most systems,
-but with @samp{-fno-range-check} the value will ``wrap around'' and @code{i}
-will be initialized to @math{-1} instead.
+Enable range checking on results of simplification of constant
+expressions during compilation. For example, by default, GNU Fortran
+will give an overflow error at compile time when simplifying @code{a =
+EXP(1000)}. With @option{-fno-range-check}, no error will be given and
+the variable @code{a} will be assigned the value @code{+Infinity}.
+Similarly, @code{DATA i/Z'FFFFFFFF'/} will result in an integer overflow
+on most systems, but with @option{-fno-range-check} the value will
+``wrap around'' and @code{i} will be initialized to @math{-1} instead.
@cindex -std=@var{std} option
@cindex option, -std=@var{std}
@cindex -std=@var{std} option
@cindex option, -std=@var{std}
Issue warnings for uses of extensions to Fortran 95.
@option{-pedantic} also applies to C-language constructs where they
occur in GNU Fortran source files, such as use of @samp{\e} in a
Issue warnings for uses of extensions to Fortran 95.
@option{-pedantic} also applies to C-language constructs where they
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
this option.
Valid Fortran 95 programs should compile properly with or without
this option.
@cindex aliasing
Warn about possible aliasing of dummy arguments. Specifically, it warns
if the same actual argument is associated with a dummy argument with
@cindex aliasing
Warn about possible aliasing of dummy arguments. Specifically, it warns
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.
The following example will trigger the warning.
with an explicit interface.
The following example will trigger the warning.
signal being sent and the program being interrupted, producing a core
file useful for debugging. @var{list} is a (possibly empty) comma-separated
list of the following IEEE exceptions: @samp{invalid} (invalid floating
signal being sent and the program being interrupted, producing a core
file useful for debugging. @var{list} is a (possibly empty) comma-separated
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),
@samp{underflow} (underflow in a floating point operation),
@samp{precision} (loss of precision during operation) and @samp{denormal}
zero), @samp{overflow} (overflow in a floating point operation),
@samp{underflow} (underflow in a floating point operation),
@samp{precision} (loss of precision during operation) and @samp{denormal}
@code{#include} in the @command{cpp} preprocessor, with regard to
looking for @file{header.gcc} files and other such things.
@code{#include} in the @command{cpp} preprocessor, with regard to
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.
@xref{Directory Options,,Options for Directory Search,
compiled modules are required by a @code{USE} statement.
@xref{Directory Options,,Options for Directory Search,
@cindex option, -Mdir
@item -M@var{dir}
@item -J@var{dir}
@cindex option, -Mdir
@item -M@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}
statement.
It is also added to the list of directories to searched by an @code{USE}
statement.
@emph{This option has an effect only when used in the main program.
The @code{CONVERT} specifier and the GFORTRAN_CONVERT_UNIT environment
@emph{This option has an effect only when used in the main program.
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}
@item -frecord-marker=@var{length}
@cindex -frecord-marker=@var{length}
@item -frecord-marker=@var{length}
@emph{This is different from previous versions of gfortran},
which specified a default record marker length of 8 on most
systems. If you want to read or write files compatible
@emph{This is different from previous versions of 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 @samp{-frecord-marker=8}.
+with earlier versions of gfortran, use @option{-frecord-marker=8}.
@cindex -fmax-subrecord-length=@var{length}
@item -fmax-subrecord-length=@var{length}
@cindex -fmax-subrecord-length=@var{length}
@item -fmax-subrecord-length=@var{length}
This does not affect the generation of code that interfaces with
the @command{libgfortran} library.
This does not affect the generation of code that interfaces with
the @command{libgfortran} library.
-@emph{Caution:} It is not a good idea to mix Fortran code compiled
-with @code{-ff2c} with code compiled with the default @code{-fno-f2c}
+@emph{Caution:} It is not a good idea to mix Fortran code compiled with
+@option{-ff2c} with code compiled with the default @option{-fno-f2c}
calling conventions as, calling @code{COMPLEX} or default @code{REAL}
functions between program parts which were compiled with different
calling conventions will break at execution time.
@emph{Caution:} This will break code which passes intrinsic functions
of type default @code{REAL} or @code{COMPLEX} as actual arguments, as
calling conventions as, calling @code{COMPLEX} or default @code{REAL}
functions between program parts which were compiled with different
calling conventions will break at execution time.
@emph{Caution:} This will break code which passes intrinsic functions
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 options, @option{-fno-underscoring}
@cindex @option{-fno-underscoring option}
@cindex options, @option{-fno-underscoring}
so on).
For example, with @option{-funderscoring}, and assuming other defaults like
so on).
For example, with @option{-funderscoring}, and assuming other defaults like
-@option{-fcase-lower} and that @samp{j()} and @samp{max_count()} are
-external functions while @samp{my_var} and @samp{lvar} are local variables,
+@option{-fcase-lower} and that @code{j()} and @code{max_count()} are
+external functions while @code{my_var} and @code{lvar} are local variables,
@smallexample
I = J() + MAX_COUNT (MY_VAR, LVAR)
@end smallexample
@smallexample
I = J() + MAX_COUNT (MY_VAR, LVAR)
@end smallexample
@noindent
is implemented as something akin to:
@noindent
is implemented as something akin to:
@smallexample
i = j_() + max_count__(&my_var__, &lvar);
@end smallexample
@smallexample
i = j_() + max_count__(&my_var__, &lvar);
@end smallexample
This option has no effect if @option{-fno-underscoring} is
in effect. It is implied by the @option{-ff2c} option.
This option has no effect if @option{-fno-underscoring} is
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
by use of the @option{-ff2c} option.
for compatibility with @command{g77} and @command{f2c}, and is implied
by use of the @option{-ff2c} option.