From 3397327cdcfe7b878320228cee615615260390a7 Mon Sep 17 00:00:00 2001 From: Brooks Moses Date: Sun, 1 Oct 2006 19:11:31 +0000 Subject: [PATCH] gfortran.texi: Corrected references to MALLOC intrinsic. 2006-10-01 Brooks Moses * gfortran.texi: Corrected references to MALLOC intrinsic. * invoke.texi: Minor cleanup and clarification to the Dialect Options section. From-SVN: r117350 --- gcc/fortran/ChangeLog | 6 ++++++ gcc/fortran/gfortran.texi | 25 ++-------------------- gcc/fortran/invoke.texi | 45 ++++++++++++++++++++++----------------- 3 files changed, 34 insertions(+), 42 deletions(-) diff --git a/gcc/fortran/ChangeLog b/gcc/fortran/ChangeLog index a37b8579fc7..ff1f55ed2ef 100644 --- a/gcc/fortran/ChangeLog +++ b/gcc/fortran/ChangeLog @@ -1,3 +1,9 @@ +2006-10-01 Brooks Moses + + * gfortran.texi: Corrected references to MALLOC intrinsic. + * invoke.texi: Minor cleanup and clarification to the Dialect + Options section. + 2006-09-30 Brooks Moses * invoke.texi: Add mention of BOZ constants and integer diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi index cd281e1d025..b74ed95d6fe 100644 --- a/gcc/fortran/gfortran.texi +++ b/gcc/fortran/gfortran.texi @@ -1081,30 +1081,9 @@ address is cast to an integer type: ipt = loc(ar) ! Makes arpte is an alias for ar arpte(1) = 1.0 ! Sets ar(1) to 1.0 @end smallexample -The pointer can also be set by a call to a malloc-type -function. There is no malloc intrinsic implemented as part of the -Cray pointer extension, but it might be a useful future addition to -@command{gfortran}. Even without an intrinsic malloc function, -dynamic memory allocation can be combined with Cray pointers by -calling a short C function: -@smallexample -mymalloc.c: +The pointer can also be set by a call to the @code{MALLOC} intrinsic +(see @ref{MALLOC}). - void mymalloc_(void **ptr, int *nbytes) - @{ - *ptr = malloc(*nbytes); - return; - @} - -caller.f: - - program caller - integer ipinfo; - real*4 data - pointer (ipdata, data(1024)) - call mymalloc(ipdata,4*1024) - end -@end smallexample Cray pointees often are used to alias an existing variable. For example: @smallexample diff --git a/gcc/fortran/invoke.texi b/gcc/fortran/invoke.texi index e0a0c474a31..0fda1febdc4 100644 --- a/gcc/fortran/invoke.texi +++ b/gcc/fortran/invoke.texi @@ -172,8 +172,8 @@ by type. Explanations are in the following sections. @cindex language, dialect options @cindex options, dialect -The following options control the dialect of Fortran -that the compiler accepts: +The following options control the details of the Fortran dialect +accepted by the compiler: @table @gcctabopt @cindex -ffree-form option @@ -189,7 +189,8 @@ that the compiler accepts: @item -ffixed-form Specify the layout used by the source file. The free form layout was introduced in Fortran 90. Fixed form was traditionally used in -older Fortran programs. +older Fortran programs. When neither option is specified, the source +form is determined by the file extension. @cindex -fall-intrinsics @item -fall-intrinsics @@ -204,16 +205,16 @@ gfortran will ignore @option{-Wnonstd-intrinsics}. @cindex -fd-lines-as-comments, option @item -fd-lines-as-code @item -fd-lines-as-comment -Enables special treating for lines with @samp{d} or @samp{D} 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 +Enable special treatment for lines beginning with @samp{d} or @samp{D} +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 @option{-fd-lines-as-comments} option is given, they are treated as comment lines. @cindex option, -fdefault-double-8 @cindex -fdefault-double-8, option @item -fdefault-double-8 -Set the "DOUBLE PRECISION" type to an 8 byte wide. +Set the @code{DOUBLE PRECISION} type to an 8 byte wide type. @cindex option, -fdefault-integer-8 @cindex -fdefault-integer-8, option @@ -240,8 +241,8 @@ Allow @samp{$} as a valid character in a symbol name. @item -fno-backslash @cindex backslash @cindex escape characters -Compile switch to change the interpretation of a backslash from -``C''-style escape characters to a single backslash character. +Change the interpretation of backslashes in string literals from +``C-style'' escape characters to a single backslash character. @cindex -ffixed-line-length-@var{n} option @cindex options, -ffixed-line-length-@var{n} @@ -258,9 +259,9 @@ 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 -standard and the default), 80 (card image), and 132 (corresponds +standard and the default), 80 (card image), and 132 (corresponding to ``extended-source'' options in some popular compilers). -@var{n} may be @samp{none}, meaning that the entire line is meaningful +@var{n} may also be @samp{none}, meaning that the entire line is meaningful and that continued character constants never have implicit spaces appended to them to fill out the line. @option{-ffixed-line-length-0} means the same thing as @@ -275,7 +276,7 @@ to them to fill out the line. @cindex free form @cindex limits, lengths of source lines Set column after which characters are ignored in typical free-form -lines in the source file. For free-form, the default value is 132. +lines in the source file. The default value is 132. @var{n} may be @samp{none}, meaning that the entire line is meaningful. @option{-ffree-line-length-0} means the same thing as @option{-ffree-line-length-none}. @@ -284,7 +285,7 @@ lines in the source file. For free-form, the default value is 132. @cindex option -fmax-identifier-length=@var{n} @item -fmax-identifier-length=@var{n} Specify the maximum allowed identifier length. Typical values are -31 (Fortran 95) and 63 (Fortran 200x). +31 (Fortran 95) and 63 (Fortran 2003). @cindex -fimplicit-none option @cindex options, -fimplicit-none @@ -296,15 +297,17 @@ Specify that no implicit typing is allowed, unless overridden by explicit @cindex -fcray-pointer option @cindex options, -fcray-pointer @item -fcray-pointer -Enables the Cray pointer extension, which provides a C-like pointer. +Enable the Cray pointer extension, which provides C-like pointer +functionality. @cindex -fopenmp @cindex options, -fopenmp @item -fopenmp -Enables handling of OpenMP @code{!$omp} directives in free form +Enable the OpenMP extensions. This includes OpenMP @code{!$omp} directives +in free form and @code{c$omp}, @code{*$omp} and @code{!$omp} directives in fixed form, -enables @code{!$} conditional compilation sentinels in free form -and @code{c$}, @code{*$} and @code{!$} sentinels in fixed form +@code{!$} conditional compilation sentinels in free form +and @code{c$}, @code{*$} and @code{!$} sentinels in fixed form, and when linking arranges for the OpenMP runtime library to be linked in. @@ -323,8 +326,12 @@ will be initialized to @math{-1} instead. @cindex -std=@var{std} option @cindex option, -std=@var{std} @item -std=@var{std} -Conform to the specified standard. Allowed values for @var{std} are -@samp{gnu}, @samp{f95}, @samp{f2003} and @samp{legacy}. +Conform to the specified standard. The default value for @var{std} is +@samp{gnu}; a superset of the Fortran 95 standard which includes all +of the GNU extensions recommended for use in new code. The @samp{legacy} +value also includes obsolete extensions that may be required for old +non-standard programs. Strict conformance to the Fortran 95 and Fortran 2003 +standards is specified by @samp{f95} and @samp{f2003}, respectively. @end table