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> 2013-12-10 Janus Weil <janus@gcc.gnu.org>
* invoke.texi: Add -freal-4-real-16. Rearrange kind promotion options. * invoke.texi: Add -freal-4-real-16. Rearrange kind promotion options.

View File

@ -1134,16 +1134,16 @@ data types are:
@table @code @table @code
@item INTEGER @item INTEGER
1, 2, 4, 8*, 16*, default: 4 (1) 1, 2, 4, 8*, 16*, default: 4**
@item LOGICAL @item LOGICAL
1, 2, 4, 8*, 16*, default: 4 (1) 1, 2, 4, 8*, 16*, default: 4**
@item REAL @item REAL
4, 8, 10*, 16*, default: 4 (2) 4, 8, 10*, 16*, default: 4***
@item COMPLEX @item COMPLEX
4, 8, 10*, 16*, default: 4 (2) 4, 8, 10*, 16*, default: 4***
@item CHARACTER @item CHARACTER
1, 4, default: 1 1, 4, default: 1
@ -1151,23 +1151,22 @@ data types are:
@end table @end table
@noindent @noindent
* = not available on all systems @* * not available on all systems @*
(1) Unless -fdefault-integer-8 is used @* ** unless @option{-fdefault-integer-8} is used @*
(2) Unless -fdefault-real-8 is used *** unless @option{-fdefault-real-8} is used (see @ref{Fortran Dialect Options})
@noindent @noindent
The @code{KIND} value matches the storage size in bytes, except for 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 @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 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 the @ref{SELECTED_CHAR_KIND}, @ref{SELECTED_INT_KIND} and
@code{SELECTED_REAL_KIND} intrinsics or the @code{INT8}, @code{INT16}, @ref{SELECTED_REAL_KIND} intrinsics or the @code{INT8}, @code{INT16},
@code{INT32}, @code{INT64}, @code{REAL32}, @code{REAL64}, and @code{REAL128} @code{INT32}, @code{INT64}, @code{REAL32}, @code{REAL64}, and @code{REAL128}
parameters of the @code{ISO_FORTRAN_ENV} module instead of the concrete values. parameters of the @code{ISO_FORTRAN_ENV} module instead of the concrete values.
The available kind parameters can be found in the constant arrays The available kind parameters can be found in the constant arrays
@code{CHARACTER_KINDS}, @code{INTEGER_KINDS}, @code{LOGICAL_KINDS} and @code{CHARACTER_KINDS}, @code{INTEGER_KINDS}, @code{LOGICAL_KINDS} and
@code{REAL_KINDS} in the @code{ISO_FORTRAN_ENV} module @code{REAL_KINDS} in the @ref{ISO_FORTRAN_ENV} module. For C interoperability,
(see @ref{ISO_FORTRAN_ENV}). For C interoperability, the kind parameters of the kind parameters of the @ref{ISO_C_BINDING} module should be used.
the @code{ISO_C_BINDING} module should be used (see @ref{ISO_C_BINDING}).
@node Internal representation of LOGICAL variables @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} @opindex @code{fdefault-integer-8}
Set the default integer and logical types to an 8 byte wide type. 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 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 @item -fdefault-real-8
@opindex @code{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 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 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 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 @item -fdefault-double-8
@opindex @code{fdefault-double-8} @opindex @code{fdefault-double-8}