diff options
Diffstat (limited to 'contrib/gcc/f/intdoc.in')
-rw-r--r-- | contrib/gcc/f/intdoc.in | 75 |
1 files changed, 38 insertions, 37 deletions
diff --git a/contrib/gcc/f/intdoc.in b/contrib/gcc/f/intdoc.in index f702fa1..55d426a 100644 --- a/contrib/gcc/f/intdoc.in +++ b/contrib/gcc/f/intdoc.in @@ -1,4 +1,4 @@ -/* Copyright (C) 1997, 1999 Free Software Foundation, Inc. +/* Copyright (C) 1997, 1999, 2003 Free Software Foundation, Inc. * This is part of the G77 manual. * For copying conditions, see the file g77.texi. */ @@ -646,7 +646,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=6)}. If @var{@1@} is type @code{COMPLEX}, its real part -is truncated and converted, and its imaginary part is disgregarded. +is truncated and converted, and its imaginary part is disregarded. @xref{Int Intrinsic}. @@ -661,7 +661,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=6)}. If @var{@1@} is type @code{COMPLEX}, its real part -is truncated and converted, and its imaginary part is disgregarded. +is truncated and converted, and its imaginary part is disregarded. @xref{Int Intrinsic}. @@ -676,7 +676,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=2)}. If @var{@1@} is type @code{COMPLEX}, its real part -is truncated and converted, and its imaginary part is disgregarded. +is truncated and converted, and its imaginary part is disregarded. @xref{Int Intrinsic}. @@ -1288,9 +1288,9 @@ zero if not, and negative if the information isn't available. ") DEFDOC (IDATE_unix, "Get local time info.", "\ -Fills @var{@1@} with the numerical values at the current local time -of day, month (in the range 1--12), and year in elements 1, 2, and 3, -respectively. +Fills @var{@1@} with the numerical values at the current local time. +The day (in the range 1--31), month (in the range 1--12), +and year appear in elements 1, 2, and 3 of @var{@1@}, respectively. The year has four significant digits. @cindex Y10K compliance @@ -1308,19 +1308,20 @@ as of the Year 10000. DEFDOC (IDATE_vxt, "Get local time info (VAX/VMS).", "\ Returns the numerical values of the current local time. The month (in the range 1--12) is returned in @var{@1@}, -the day (in the range 1--7) in @var{@2@}, +the day (in the range 1--31) in @var{@2@}, and the year in @var{@3@} (in the range 0--99). @cindex Y2K compliance @cindex Year 2000 compliance @cindex wraparound, Y2K @cindex limits, Y2K -This intrinsic is not recommended, due to the year 2000 approaching. -Therefore, programs making use of this intrinsic -might not be Year 2000 (Y2K) compliant. +This intrinsic is not recommended, due to the fact that +its return value for year wraps around century boundaries +(change from a larger value to a smaller one). +Therefore, programs making use of this intrinsic, for +instance, might not be Year 2000 (Y2K) compliant. For example, the date might appear, to such programs, to wrap around -(change from a larger value to a smaller one) as of the Year 2000. @xref{IDate Intrinsic (UNIX)}, for information on obtaining more digits @@ -1584,7 +1585,7 @@ almost certainly want to use something better. ") DEFDOC (SRAND, "Random seed.", "\ -Reinitialises the generator with the seed in @var{@1@}. +Reinitializes the generator with the seed in @var{@1@}. @xref{IRand Intrinsic}. @xref{Rand Intrinsic}. ") @@ -1617,7 +1618,7 @@ Existence DEFDOC (CHDIR_subr, "Change directory.", "\ Sets the current working directory to be @var{@1@}. If the @var{@2@} argument is supplied, it contains 0 -on success or a non-zero error code otherwise upon return. +on success or a nonzero error code otherwise upon return. See @code{chdir(3)}. @emph{Caution:} Using this routine during I/O to a unit connected with a @@ -1631,7 +1632,7 @@ only a function, not as a subroutine, or do not support the DEFDOC (CHDIR_func, "Change directory.", "\ Sets the current working directory to be @var{@1@}. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. See @code{chdir(3)}. @emph{Caution:} Using this routine during I/O to a unit connected with a @@ -1652,7 +1653,7 @@ trailing blanks in @var{@1@} are ignored. Currently, @var{@1@} must not contain the single quote character. -Returns 0 on success or a non-zero error code otherwise. +Returns 0 on success or a nonzero error code otherwise. Note that this currently works by actually invoking @code{/bin/chmod} (or the @code{chmod} found when @@ -1674,7 +1675,7 @@ Currently, @var{@1@} must not contain the single quote character. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. Note that this currently works by actually invoking @code{/bin/chmod} (or the @code{chmod} found when @@ -1689,7 +1690,7 @@ only a function, not as a subroutine, or do not support the DEFDOC (GETCWD_func, "Get current working directory.", "\ Places the current working directory in @var{@1@}. Returns 0 on -success, otherwise a non-zero error code +success, otherwise a nonzero error code (@code{ENOSYS} if the system does not provide @code{getcwd(3)} or @code{getwd(3)}). ") @@ -1697,7 +1698,7 @@ or @code{getwd(3)}). DEFDOC (GETCWD_subr, "Get current working directory.", "\ Places the current working directory in @var{@1@}. If the @var{@2@} argument is supplied, it contains 0 -success or a non-zero error code upon return +success or a nonzero error code upon return (@code{ENOSYS} if the system does not provide @code{getcwd(3)} or @code{getwd(3)}). @@ -1758,7 +1759,7 @@ Number of blocks allocated (-1 if not available) Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. ") DEFDOC (FSTAT_subr, "Get file information.", "\ @@ -1814,7 +1815,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. Some non-GNU implementations of Fortran provide this intrinsic as only a function, not as a subroutine, or do not support the @@ -1878,7 +1879,7 @@ Number of blocks allocated (-1 if not available) Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. -Returns 0 on success or a non-zero error code +Returns 0 on success or a nonzero error code (@code{ENOSYS} if the system does not provide @code{lstat(2)}). ") @@ -1940,7 +1941,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return +0 on success or a nonzero error code upon return (@code{ENOSYS} if the system does not provide @code{lstat(2)}). Some non-GNU implementations of Fortran provide this intrinsic as @@ -2002,7 +2003,7 @@ Number of blocks allocated (-1 if not available) Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. ") DEFDOC (STAT_subr, "Get file information.", "\ @@ -2060,7 +2061,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. Some non-GNU implementations of Fortran provide this intrinsic as only a function, not as a subroutine, or do not support the @@ -2073,7 +2074,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. See @code{link(2)}. Some non-GNU implementations of Fortran provide this intrinsic as @@ -2086,7 +2087,7 @@ Makes a (hard) link from file @var{@1@} to @var{@2@}. A null character (@samp{CHAR(0)}) marks the end of the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. See @code{link(2)}. Due to the side effects performed by this intrinsic, the function @@ -2099,7 +2100,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return +0 on success or a nonzero error code upon return (@code{ENOSYS} if the system does not provide @code{symlink(2)}). Some non-GNU implementations of Fortran provide this intrinsic as @@ -2112,7 +2113,7 @@ Makes a symbolic link from file @var{@1@} to @var{@2@}. A null character (@samp{CHAR(0)}) marks the end of the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. -Returns 0 on success or a non-zero error code +Returns 0 on success or a nonzero error code (@code{ENOSYS} if the system does not provide @code{symlink(2)}). Due to the side effects performed by this intrinsic, the function @@ -2126,7 +2127,7 @@ the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. See @code{rename(2)}. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. Some non-GNU implementations of Fortran provide this intrinsic as only a function, not as a subroutine, or do not support the @@ -2139,7 +2140,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{@1@} and @var{@2@}---otherwise, trailing blanks in @var{@1@} and @var{@2@} are ignored. See @code{rename(2)}. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. Due to the side effects performed by this intrinsic, the function form is not recommended. @@ -2168,7 +2169,7 @@ A null character (@samp{CHAR(0)}) marks the end of the name in @var{@1@}---otherwise, trailing blanks in @var{@1@} are ignored. If the @var{@2@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. See @code{unlink(2)}. Some non-GNU implementations of Fortran provide this intrinsic as @@ -2181,7 +2182,7 @@ Unlink the file @var{@1@}. A null character (@samp{CHAR(0)}) marks the end of the name in @var{@1@}---otherwise, trailing blanks in @var{@1@} are ignored. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. See @code{unlink(2)}. Due to the side effects performed by this intrinsic, the function @@ -2238,7 +2239,7 @@ in @var{@1@}. DEFDOC (HOSTNM_func, "Get host name.", "\ Fills @var{@1@} with the system's host name returned by -@code{gethostname(2)}, returning 0 on success or a non-zero error code +@code{gethostname(2)}, returning 0 on success or a nonzero error code (@code{ENOSYS} if the system does not provide @code{gethostname(2)}). On some systems (specifically SCO) it might be necessary to link the @@ -2251,7 +2252,7 @@ DEFDOC (HOSTNM_subr, "Get host name.", "\ Fills @var{@1@} with the system's host name returned by @code{gethostname(2)}. If the @var{@2@} argument is supplied, it contains -0 on success or a non-zero error code upon return +0 on success or a nonzero error code upon return (@code{ENOSYS} if the system does not provide @code{gethostname(2)}). Some non-GNU implementations of Fortran provide this intrinsic as @@ -2513,7 +2514,7 @@ allowing you to take appropriate action. DEFDOC (KILL_func, "Signal a process.", "\ Sends the signal specified by @var{@2@} to the process @var{@1@}. -Returns 0 on success or a non-zero error code. +Returns 0 on success or a nonzero error code. See @code{kill(2)}. Due to the side effects performed by this intrinsic, the function @@ -2523,7 +2524,7 @@ form is not recommended. DEFDOC (KILL_subr, "Signal a process.", "\ Sends the signal specified by @var{@2@} to the process @var{@1@}. If the @var{@3@} argument is supplied, it contains -0 on success or a non-zero error code upon return. +0 on success or a nonzero error code upon return. See @code{kill(2)}. Some non-GNU implementations of Fortran provide this intrinsic as |