Re: POSIX test #14 on UTS

[p5sagit/p5-mst-13.2.git] / ext / POSIX / POSIX.pod

diff --git a/ext/POSIX/POSIX.pod b/ext/POSIX/POSIX.pod
index 9abad2a..9eb9116 100644 (file)
--- a/ext/POSIX/POSIX.pod
+++ b/ext/POSIX/POSIX.pod
@@ -95,7 +95,7 @@ I<race condition>.
 =item acos
 
 This is identical to the C function C<acos()>, returning
-the arcus cosine of its numerical argument.
+the arcus cosine of its numerical argument.  See also L<Math::Trig>.
 
 =item alarm
 
@@ -121,7 +121,7 @@ default to zero (and the first two are usually ignored anyway).
 =item asin
 
 This is identical to the C function C<asin()>, returning
-the arcus sine of its numerical argument.
+the arcus sine of its numerical argument.  See also L<Math::Trig>.
 
 =item assert
 
@@ -131,13 +131,13 @@ to achieve similar things.
 =item atan
 
 This is identical to the C function C<atan()>, returning the
-arcus tangent of its numerical argument.
+arcus tangent of its numerical argument.  See also L<Math::Trig>.
 
 =item atan2
 
 This is identical to Perl's builtin C<atan2()> function, returning
 the arcus tangent defined by its two numerical arguments, the I<y>
-coordinate and the I<x> coordinate.
+coordinate and the I<x> coordinate.  See also L<Math::Trig>.
 
 =item atexit
 
@@ -220,11 +220,12 @@ a directory handle, see L<perlfunc/closedir>.
 
 This is identical to Perl's builtin C<cos()> function, for returning
 the cosine of its numerical argument, see L<perlfunc/cos>.
+See also L<Math::Trig>.
 
 =item cosh
 
 This is identical to the C function C<cosh()>, for returning
-the hyperbolic cosine of its numeric argument.
+the hyperbolic cosine of its numeric argument.  See also L<Math::Trig>.
 
 =item creat
 
@@ -334,7 +335,7 @@ the absolute value of the numerical argument, see L<perlfunc/abs>.
 
 =item fclose
 
-Use method C<IO::Handle::close()> instead.
+Use method C<IO::Handle::close()> instead, or see L<perlfunc/close>.
 
 =item fcntl
 
@@ -343,11 +344,11 @@ see L<perlfunc/fcntl>.
 
 =item fdopen
 
-Use method C<IO::Handle::new_from_fd()> instead.
+Use method C<IO::Handle::new_from_fd()> instead, or see L<perlfunc/open>.
 
 =item feof
 
-Use method C<IO::Handle::eof()> instead.
+Use method C<IO::Handle::eof()> instead, or see L<perlfunc/eof>.
 
 =item ferror
 
@@ -356,14 +357,15 @@ Use method C<IO::Handle::error()> instead.
 =item fflush
 
 Use method C<IO::Handle::flush()> instead.
+See also L<perlvar/$OUTPUT_AUTOFLUSH>.
 
 =item fgetc
 
-Use method C<IO::Handle::getc()> instead.
+Use method C<IO::Handle::getc()> instead, or see L<perlfunc/read>.
 
 =item fgetpos
 
-Use method C<IO::Seekable::getpos()> instead.
+Use method C<IO::Seekable::getpos()> instead, or see L<L/seek>.
 
 =item fgets
 
@@ -372,7 +374,7 @@ as L<perlfunc/readline>.
 
 =item fileno
 
-Use method C<IO::Handle::fileno()> instead.
+Use method C<IO::Handle::fileno()> instead, or see L<perlfunc/fileno>.
 
 =item floor
 
@@ -391,11 +393,13 @@ less than the magnitude of C<$y>.
 
 =item fopen
 
-Use method C<IO::File::open()> instead.
+Use method C<IO::File::open()> instead, or see L<perlfunc/open>.
 
 =item fork
 
-This is identical to Perl's builtin C<fork()> function.
+This is identical to Perl's builtin C<fork()> function
+for duplicating the current process, see L<perlfunc/fork>
+and L<perlfork> if you are in Windows.
 
 =item fpathconf
 
@@ -446,11 +450,11 @@ fscanf() is C-specific, use E<lt>E<gt> and regular expressions instead.
 
 =item fseek
 
-Use method C<IO::Seekable::seek()> instead.
+Use method C<IO::Seekable::seek()> instead, or see L<perlfunc/seek>.
 
 =item fsetpos
 
-Use method C<IO::Seekable::setpos()> instead.
+Use method C<IO::Seekable::setpos()> instead, or seek L<perlfunc/seek>.
 
 =item fstat
 
@@ -463,7 +467,7 @@ Perl's builtin C<stat> function.
 
 =item ftell
 
-Use method C<IO::Seekable::tell()> instead.
+Use method C<IO::Seekable::tell()> instead, or see L<perlfunc/tell>.
 
 =item fwrite
 
@@ -648,7 +652,7 @@ C</[[:isxdigit:]]/> construct instead, or simply C</[0-9a-f]/i>.
 =item kill
 
 This is identical to Perl's builtin C<kill()> function for sending
-signals to processes (oftern to terminate them), see L<perlfunc/kill>.
+signals to processes (often to terminate them), see L<perlfunc/kill>.
 
 =item labs
 
@@ -1004,9 +1008,12 @@ see L<perlre>.
 
 =item setgid
 
-Sets the real group identifier for this process.
-Identical to assigning a value to the Perl's builtin C<$)> variable,
-see L<perlvar/$UID>.
+Sets the real group identifier and the effective group identifier for
+this process.  Similar to assigning a value to the Perl's builtin
+C<$)> variable, see L<perlvar/$GID>, except that the latter
+will change only the real user identifier, and that the setgid()
+uses only a single numeric argument, as opposed to a space-separated
+list of numbers.
 
 =item setjmp
 
@@ -1059,9 +1066,10 @@ setting the session identifier of the current process.
 
 =item setuid
 
-Sets the real user identifier for this process.
-Identical to assigning a value to the Perl's builtin C<$E<lt>> variable,
-see L<perlvar/$UID>.
+Sets the real user identifier and the effective user identifier for
+this process.  Similar to assigning a value to the Perl's builtin
+C<$E<lt>> variable, see L<perlvar/$UID>, except that the latter
+will change only the real user identifier.
 
 =item sigaction
 
@@ -1124,12 +1132,13 @@ Returns C<undef> on failure.
 
 This is identical to Perl's builtin C<sin()> function
 for returning the sine of the numerical argument,
-see L<perlfunc/sin>.
+see L<perlfunc/sin>.  See also L<Math::Trig>.
 
 =item sinh
 
 This is identical to the C function C<sinh()>
 for returning the hyperbolic sine of the numerical argument.
+See also L<Math::Trig>.
 
 =item sleep
 
@@ -1221,6 +1230,8 @@ The string for Tuesday, December 12, 1995.
        $str = POSIX::strftime( "%A, %B %d, %Y", 0, 0, 0, 12, 11, 95, 2 );
        print "$str\n";
 
+See also L<Time::Piece>.
+
 =item strlen
 
 strlen() is C-specific, use C<length()> instead, see L<perlfunc/length>.
@@ -1352,12 +1363,12 @@ L<perlfunc/system>.
 =item tan
 
 This is identical to the C function C<tan()>, returning the
-tangent of the numerical argument.
+tangent of the numerical argument.  See also L<Math::Trig>.
 
 =item tanh
 
 This is identical to the C function C<tanh()>, returning the
-hyperbolic tangent of the numerical argument.
+hyperbolic tangent of the numerical argument.   See also L<Math::Trig>.
 
 =item tcdrain
 
@@ -1429,7 +1440,9 @@ Returns a name for a temporary file.
 
        $tmpfile = POSIX::tmpnam();
 
-See also L<File::Temp>.
+For security reasons, which are probably detailed in your system's
+documentation for the C library tmpnam() function, this interface
+should not be used; instead see L<File::Temp>.
 
 =item tolower