From: Janus Weil Date: Mon, 19 Dec 2016 10:26:04 +0000 (+0100) Subject: re PR fortran/78545 (Possible correction to online LTIME documentation) X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=99eb50e806f51a37f8188fd268a6abbb7d292927;p=gcc.git re PR fortran/78545 (Possible correction to online LTIME documentation) 2016-12-19 Janus Weil 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 --- diff --git a/gcc/fortran/ChangeLog b/gcc/fortran/ChangeLog index d7ce88f60dc..7b653ce61cd 100644 --- a/gcc/fortran/ChangeLog +++ b/gcc/fortran/ChangeLog @@ -1,3 +1,10 @@ +2016-12-19 Janus Weil + + 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 PR fortran/78545 diff --git a/gcc/fortran/intrinsic.texi b/gcc/fortran/intrinsic.texi index 300a938e9a1..24920eb3498 100644 --- a/gcc/fortran/intrinsic.texi +++ b/gcc/fortran/intrinsic.texi @@ -4583,7 +4583,7 @@ end program test_cshift @table @asis @item @emph{Description}: @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}. 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 @item @emph{Description}: @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())}. This intrinsic is provided in both subroutine and function forms; however, @@ -7157,7 +7157,7 @@ See @code{GETPID} for an example. @table @asis @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 to the UTC time zone (Universal Coordinated Time, also known in some 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 @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 @@ -7879,8 +7879,10 @@ program test_idate print *, tarray(3) end program test_idate @end smallexample -@end table +@item @emph{See also}: +@ref{DATE_AND_TIME} +@end table @node IEOR @@ -8699,6 +8701,9 @@ program test_itime print *, tarray(3) end program test_itime @end smallexample + +@item @emph{See also}: +@ref{DATE_AND_TIME} @end table @@ -9650,7 +9655,7 @@ To stat an open file: @ref{FSTAT}, to stat a file: @ref{STAT} @table @asis @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 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 @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 @@ -13885,7 +13890,7 @@ IF (THIS_IMAGE(HUGE(1)) /= THIS_IMAGE()) @item @emph{Description}: 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 -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 @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)}. @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 @@ -13926,7 +13931,7 @@ The return value is a scalar of type @code{INTEGER(4)}. @item @emph{Description}: 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 -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 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)}. @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