gfortran.texi: Modify documentation of kind type parameters.

2013-12-10  Janus Weil  <janus@gcc.gnu.org>

	* gfortran.texi: Modify documentation of kind type parameters.
	* invoke.texi: Extend documentation of -fdefault-integer-8 and
	-fdefault-real-8.

From-SVN: r205862
This commit is contained in:
Janus Weil 2013-12-10 17:44:04 +01:00
parent e7b4ce6414
commit a4cf752c51
3 changed files with 22 additions and 14 deletions

View File

@ -1,3 +1,9 @@
2013-12-10 Janus Weil <janus@gcc.gnu.org>
* gfortran.texi: Modify documentation of kind type parameters.
* invoke.texi: Extend documentation of -fdefault-integer-8 and
-fdefault-real-8.
2013-12-10 Janus Weil <janus@gcc.gnu.org>
* invoke.texi: Add -freal-4-real-16. Rearrange kind promotion options.

View File

@ -1134,16 +1134,16 @@ data types are:
@table @code
@item INTEGER
1, 2, 4, 8*, 16*, default: 4 (1)
1, 2, 4, 8*, 16*, default: 4**
@item LOGICAL
1, 2, 4, 8*, 16*, default: 4 (1)
1, 2, 4, 8*, 16*, default: 4**
@item REAL
4, 8, 10*, 16*, default: 4 (2)
4, 8, 10*, 16*, default: 4***
@item COMPLEX
4, 8, 10*, 16*, default: 4 (2)
4, 8, 10*, 16*, default: 4***
@item CHARACTER
1, 4, default: 1
@ -1151,23 +1151,22 @@ data types are:
@end table
@noindent
* = not available on all systems @*
(1) Unless -fdefault-integer-8 is used @*
(2) Unless -fdefault-real-8 is used
* not available on all systems @*
** unless @option{-fdefault-integer-8} is used @*
*** unless @option{-fdefault-real-8} is used (see @ref{Fortran Dialect Options})
@noindent
The @code{KIND} value matches the storage size in bytes, except for
@code{COMPLEX} where the storage size is twice as much (or both real and
imaginary part are a real value of the given size). It is recommended to use
the @code{SELECTED_CHAR_KIND}, @code{SELECTED_INT_KIND} and
@code{SELECTED_REAL_KIND} intrinsics or the @code{INT8}, @code{INT16},
the @ref{SELECTED_CHAR_KIND}, @ref{SELECTED_INT_KIND} and
@ref{SELECTED_REAL_KIND} intrinsics or the @code{INT8}, @code{INT16},
@code{INT32}, @code{INT64}, @code{REAL32}, @code{REAL64}, and @code{REAL128}
parameters of the @code{ISO_FORTRAN_ENV} module instead of the concrete values.
The available kind parameters can be found in the constant arrays
@code{CHARACTER_KINDS}, @code{INTEGER_KINDS}, @code{LOGICAL_KINDS} and
@code{REAL_KINDS} in the @code{ISO_FORTRAN_ENV} module
(see @ref{ISO_FORTRAN_ENV}). For C interoperability, the kind parameters of
the @code{ISO_C_BINDING} module should be used (see @ref{ISO_C_BINDING}).
@code{REAL_KINDS} in the @ref{ISO_FORTRAN_ENV} module. For C interoperability,
the kind parameters of the @ref{ISO_C_BINDING} module should be used.
@node Internal representation of LOGICAL variables

View File

@ -331,7 +331,9 @@ on most systems, but with @option{-fno-range-check} the value will
@opindex @code{fdefault-integer-8}
Set the default integer and logical types to an 8 byte wide type.
Do nothing if this is already the default. This option also affects
the kind of integer constants like @code{42}.
the kind of integer constants like @code{42}. Unlike
@option{-finteger-4-integer-8}, it does not promote variables with explicit
kind declaration.
@item -fdefault-real-8
@opindex @code{fdefault-real-8}
@ -339,7 +341,8 @@ Set the default real type to an 8 byte wide type.
Do nothing if this is already the default. This option also affects
the kind of non-double real constants like @code{1.0}, and does promote
the default width of @code{DOUBLE PRECISION} to 16 bytes if possible, unless
@code{-fdefault-double-8} is given, too.
@code{-fdefault-double-8} is given, too. Unlike @option{-freal-4-real-8},
it does not promote variables with explicit kind declaration.
@item -fdefault-double-8
@opindex @code{fdefault-double-8}