re PR fortran/78545 (Possible correction to online LTIME documentation)

2016-12-19  Janus Weil  <janus@gcc.gnu.org>

	PR fortran/78545
	* intrinsic.texi: Minor documentation fixes for non-standard
	time-related intrinsics. Add references to standard intrinsics and
	linkify some existing references.

From-SVN: r243794
This commit is contained in:
Janus Weil 2016-12-19 11:26:04 +01:00
parent ad7ab32ed4
commit 99eb50e806
2 changed files with 23 additions and 11 deletions

View File

@ -1,3 +1,10 @@
2016-12-19 Janus Weil <janus@gcc.gnu.org>
PR fortran/78545
* intrinsic.texi: Minor documentation fixes for non-standard
time-related intrinsics. Add references to standard intrinsics and
linkify some existing references.
2016-12-18 Dominique d'Humieres <dominiq@lps.ens.fr> 2016-12-18 Dominique d'Humieres <dominiq@lps.ens.fr>
PR fortran/78545 PR fortran/78545

View File

@ -4583,7 +4583,7 @@ end program test_cshift
@table @asis @table @asis
@item @emph{Description}: @item @emph{Description}:
@code{CTIME} converts a system time value, such as returned by @code{CTIME} converts a system time value, such as returned by
@code{TIME8}, to a string. The output will be of the form @samp{Sat @ref{TIME8}, to a string. The output will be of the form @samp{Sat
Aug 19 18:13:14 1995}. Aug 19 18:13:14 1995}.
This intrinsic is provided in both subroutine and function forms; however, This intrinsic is provided in both subroutine and function forms; however,
@ -5843,7 +5843,7 @@ the dynamic type of A is an extension type of the dynamic type of MOLD.
@table @asis @table @asis
@item @emph{Description}: @item @emph{Description}:
@code{FDATE(DATE)} returns the current date (using the same format as @code{FDATE(DATE)} returns the current date (using the same format as
@code{CTIME}) in @var{DATE}. It is equivalent to @code{CALL CTIME(DATE, @ref{CTIME}) in @var{DATE}. It is equivalent to @code{CALL CTIME(DATE,
TIME())}. TIME())}.
This intrinsic is provided in both subroutine and function forms; however, This intrinsic is provided in both subroutine and function forms; however,
@ -7157,7 +7157,7 @@ See @code{GETPID} for an example.
@table @asis @table @asis
@item @emph{Description}: @item @emph{Description}:
Given a system time value @var{TIME} (as provided by the @code{TIME} Given a system time value @var{TIME} (as provided by the @ref{TIME}
intrinsic), fills @var{VALUES} with values extracted from it appropriate intrinsic), fills @var{VALUES} with values extracted from it appropriate
to the UTC time zone (Universal Coordinated Time, also known in some to the UTC time zone (Universal Coordinated Time, also known in some
countries as GMT, Greenwich Mean Time), using @code{gmtime(3)}. countries as GMT, Greenwich Mean Time), using @code{gmtime(3)}.
@ -7201,7 +7201,7 @@ effect, zero if not, and negative if the information is not available.
@end enumerate @end enumerate
@item @emph{See also}: @item @emph{See also}:
@ref{CTIME}, @ref{LTIME}, @ref{TIME}, @ref{TIME8} @ref{DATE_AND_TIME}, @ref{CTIME}, @ref{LTIME}, @ref{TIME}, @ref{TIME8}
@end table @end table
@ -7879,8 +7879,10 @@ program test_idate
print *, tarray(3) print *, tarray(3)
end program test_idate end program test_idate
@end smallexample @end smallexample
@end table
@item @emph{See also}:
@ref{DATE_AND_TIME}
@end table
@node IEOR @node IEOR
@ -8699,6 +8701,9 @@ program test_itime
print *, tarray(3) print *, tarray(3)
end program test_itime end program test_itime
@end smallexample @end smallexample
@item @emph{See also}:
@ref{DATE_AND_TIME}
@end table @end table
@ -9650,7 +9655,7 @@ To stat an open file: @ref{FSTAT}, to stat a file: @ref{STAT}
@table @asis @table @asis
@item @emph{Description}: @item @emph{Description}:
Given a system time value @var{TIME} (as provided by the @code{TIME} Given a system time value @var{TIME} (as provided by the @ref{TIME}
intrinsic), fills @var{VALUES} with values extracted from it appropriate intrinsic), fills @var{VALUES} with values extracted from it appropriate
to the local time zone using @code{localtime(3)}. to the local time zone using @code{localtime(3)}.
@ -9693,7 +9698,7 @@ effect, zero if not, and negative if the information is not available.
@end enumerate @end enumerate
@item @emph{See also}: @item @emph{See also}:
@ref{CTIME}, @ref{GMTIME}, @ref{TIME}, @ref{TIME8} @ref{DATE_AND_TIME}, @ref{CTIME}, @ref{GMTIME}, @ref{TIME}, @ref{TIME8}
@end table @end table
@ -13885,7 +13890,7 @@ IF (THIS_IMAGE(HUGE(1)) /= THIS_IMAGE())
@item @emph{Description}: @item @emph{Description}:
Returns the current time encoded as an integer (in the manner of the Returns the current time encoded as an integer (in the manner of the
function @code{time(3)} in the C standard library). This value is function @code{time(3)} in the C standard library). This value is
suitable for passing to @code{CTIME}, @code{GMTIME}, and @code{LTIME}. suitable for passing to @ref{CTIME}, @ref{GMTIME}, and @ref{LTIME}.
This intrinsic is not fully portable, such as to systems with 32-bit This intrinsic is not fully portable, such as to systems with 32-bit
@code{INTEGER} types but supporting times wider than 32 bits. Therefore, @code{INTEGER} types but supporting times wider than 32 bits. Therefore,
@ -13910,7 +13915,7 @@ Function
The return value is a scalar of type @code{INTEGER(4)}. The return value is a scalar of type @code{INTEGER(4)}.
@item @emph{See also}: @item @emph{See also}:
@ref{CTIME}, @ref{GMTIME}, @ref{LTIME}, @ref{MCLOCK}, @ref{TIME8} @ref{DATE_AND_TIME}, @ref{CTIME}, @ref{GMTIME}, @ref{LTIME}, @ref{MCLOCK}, @ref{TIME8}
@end table @end table
@ -13926,7 +13931,7 @@ The return value is a scalar of type @code{INTEGER(4)}.
@item @emph{Description}: @item @emph{Description}:
Returns the current time encoded as an integer (in the manner of the Returns the current time encoded as an integer (in the manner of the
function @code{time(3)} in the C standard library). This value is function @code{time(3)} in the C standard library). This value is
suitable for passing to @code{CTIME}, @code{GMTIME}, and @code{LTIME}. suitable for passing to @ref{CTIME}, @ref{GMTIME}, and @ref{LTIME}.
@emph{Warning:} this intrinsic does not increase the range of the timing @emph{Warning:} this intrinsic does not increase the range of the timing
values over that returned by @code{time(3)}. On a system with a 32-bit values over that returned by @code{time(3)}. On a system with a 32-bit
@ -13949,7 +13954,7 @@ Function
The return value is a scalar of type @code{INTEGER(8)}. The return value is a scalar of type @code{INTEGER(8)}.
@item @emph{See also}: @item @emph{See also}:
@ref{CTIME}, @ref{GMTIME}, @ref{LTIME}, @ref{MCLOCK8}, @ref{TIME} @ref{DATE_AND_TIME}, @ref{CTIME}, @ref{GMTIME}, @ref{LTIME}, @ref{MCLOCK8}, @ref{TIME}
@end table @end table