diff options
Diffstat (limited to 'contrib/gcc/f/intdoc.texi')
| -rw-r--r-- | contrib/gcc/f/intdoc.texi | 73 |
1 files changed, 37 insertions, 36 deletions
diff --git a/contrib/gcc/f/intdoc.texi b/contrib/gcc/f/intdoc.texi index e829b35..7de4257 100644 --- a/contrib/gcc/f/intdoc.texi +++ b/contrib/gcc/f/intdoc.texi @@ -2226,7 +2226,7 @@ Description: Sets the current working directory to be @var{Dir}. If the @var{Status} 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 @@ -2265,7 +2265,7 @@ Intrinsic groups: @code{badu77}. Description: Sets the current working directory to be @var{Dir}. -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 @@ -2315,7 +2315,7 @@ Currently, @var{Name} must not contain the single quote character. If the @var{Status} 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 @@ -2365,7 +2365,7 @@ trailing blanks in @var{Name} are ignored. Currently, @var{Name} 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 @@ -5067,7 +5067,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{Status} 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 @@ -5152,7 +5152,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. For information on other intrinsics with the same name: @xref{FStat Intrinsic (subroutine)}. @@ -5292,7 +5292,7 @@ Description: Places the current working directory in @var{Name}. If the @var{Status} 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)}). @@ -5327,7 +5327,7 @@ Description: Places the current working directory in @var{Name}. 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)}). @@ -5537,7 +5537,7 @@ Description: Fills @var{Name} with the system's host name returned by @code{gethostname(2)}. If the @var{Status} 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 @@ -5575,7 +5575,7 @@ Intrinsic groups: @code{unix}. Description: Fills @var{Name} 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 @@ -5893,9 +5893,9 @@ Intrinsic groups: @code{unix}. @noindent Description: -Fills @var{TArray} 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{TArray} 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{TArray}, respectively. The year has four significant digits. @cindex Y10K compliance @@ -5941,19 +5941,20 @@ Description: Returns the numerical values of the current local time. The month (in the range 1--12) is returned in @var{M}, -the day (in the range 1--7) in @var{D}, +the day (in the range 1--31) in @var{D}, and the year in @var{Y} (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 @@ -6543,7 +6544,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=6)}. If @var{A} 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}. @@ -6578,7 +6579,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=2)}. If @var{A} 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}. @@ -7107,7 +7108,7 @@ Description: Sends the signal specified by @var{Signal} to the process @var{Pid}. If the @var{Status} 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 @@ -7145,7 +7146,7 @@ Intrinsic groups: @code{badu77}. Description: Sends the signal specified by @var{Signal} to the process @var{Pid}. -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 @@ -7377,7 +7378,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} are ignored. If the @var{Status} 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 @@ -7418,7 +7419,7 @@ Makes a (hard) link from file @var{Path1} to @var{Path2}. A null character (@samp{CHAR(0)}) marks the end of the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} 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 @@ -7802,7 +7803,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{Status} 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 @@ -7893,7 +7894,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)}). For information on other intrinsics with the same name: @@ -9085,7 +9086,7 @@ the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} are ignored. See @code{rename(2)}. If the @var{Status} 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 @@ -9126,7 +9127,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} 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. @@ -9418,7 +9419,7 @@ magnitude truncated and its sign preserved, converted to type @code{INTEGER(KIND=6)}. If @var{A} 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}. @@ -9848,7 +9849,7 @@ Intrinsic groups: @code{unix}. @noindent Description: -Reinitialises the generator with the seed in @var{Seed}. +Reinitializes the generator with the seed in @var{Seed}. @xref{IRand Intrinsic}. @xref{Rand Intrinsic}. @@ -9931,7 +9932,7 @@ Not all these elements are relevant on all systems. If an element is not relevant, it is returned as 0. If the @var{Status} 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 @@ -10018,7 +10019,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. For information on other intrinsics with the same name: @xref{Stat Intrinsic (subroutine)}. @@ -10067,7 +10068,7 @@ A null character (@samp{CHAR(0)}) marks the end of the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} are ignored. If the @var{Status} 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 @@ -10108,7 +10109,7 @@ Makes a symbolic link from file @var{Path1} to @var{Path2}. A null character (@samp{CHAR(0)}) marks the end of the names in @var{Path1} and @var{Path2}---otherwise, trailing blanks in @var{Path1} and @var{Path2} 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 @@ -10657,7 +10658,7 @@ A null character (@samp{CHAR(0)}) marks the end of the name in @var{File}---otherwise, trailing blanks in @var{File} are ignored. If the @var{Status} 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 @@ -10695,7 +10696,7 @@ Unlink the file @var{File}. A null character (@samp{CHAR(0)}) marks the end of the name in @var{File}---otherwise, trailing blanks in @var{File} 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 |
