From 47cd99a476cec03355d01f7362c0175ff9e1c16e Mon Sep 17 00:00:00 2001 From: "Michael G. Schwern" Date: Mon, 16 May 2005 08:17:05 -0700 Subject: [PATCH] [PATCH] Eliminate radically out of date CHANGES from perlport Date: Mon, 16 May 2005 15:17:05 -0700 Message-ID: <20050516221705.GA212@windhund.schwern.org> Subject: [PATCH] Eliminate function signatures from perlport From: Michael G Schwern Date: Mon, 16 May 2005 15:24:18 -0700 Message-ID: <20050516222418.GA422@windhund.schwern.org> p4raw-id: //depot/perl@24496 --- pod/perlport.pod | 226 +++++++++++++------------------------------------------ 1 file changed, 54 insertions(+), 172 deletions(-) diff --git a/pod/perlport.pod b/pod/perlport.pod index f4e6ddf..e250ea1 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -1498,10 +1498,6 @@ L for a full description of available variables. =over 8 -=item -X FILEHANDLE - -=item -X EXPR - =item -X C<-r>, C<-w>, and C<-x> have a limited meaning only; directories @@ -1540,7 +1536,7 @@ suffixes. C<-S> is meaningless. (Win32) C<-x> (or C<-X>) determine if a file has an executable file type. (S) -=item atan2 Y,X +=item atan2 Due to issues with various CPUs, math libraries, compilers, and standards, results for C may vary depending on any combination of the above. @@ -1551,7 +1547,7 @@ run on does not allow it. (Tru64, HP-UX 10.20) The current version of the standards for C is available at L. -=item binmode FILEHANDLE +=item binmode Meaningless. (S, S) @@ -1562,7 +1558,7 @@ filehandle may be closed, or pointer may be in a different position. The value returned by C may be affected after the call, and the filehandle may be flushed. (Win32) -=item chmod LIST +=item chmod Only limited meaning. Disabling/enabling write permission is mapped to locking/unlocking the file. (S) @@ -1577,7 +1573,7 @@ Access permissions are mapped onto VOS access-control list changes. (VOS) The actual permissions set depend on the value of the C in the SYSTEM environment settings. (Cygwin) -=item chown LIST +=item chown Not implemented. (S, Win32, S, S) @@ -1585,26 +1581,24 @@ Does nothing, but won't fail. (Win32) A little funky, because VOS's notion of ownership is a little funky (VOS). -=item chroot FILENAME - =item chroot Not implemented. (S, Win32, VMS, S, S, VOS, VM/ESA) -=item crypt PLAINTEXT,SALT +=item crypt May not be available if library or source was not provided when building perl. (Win32) -=item dbmclose HASH +=item dbmclose Not implemented. (VMS, S, VOS) -=item dbmopen HASH,DBNAME,MODE +=item dbmopen Not implemented. (VMS, S, VOS) -=item dump LABEL +=item dump Not useful. (S, S) @@ -1612,7 +1606,7 @@ Not implemented. (Win32) Invokes VMS debugger. (VMS) -=item exec LIST +=item exec Not implemented. (S) @@ -1621,8 +1615,6 @@ Implemented via Spawn. (VM/ESA) Does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX) -=item exit EXPR - =item exit Emulates UNIX exit() (which considers C to indicate an error) by @@ -1632,11 +1624,11 @@ function, C is also mapped to an exit status of SS$_NORMAL (C<1>); this mapping cannot be overridden. Any other argument to exit() is used directly as Perl's exit status. (VMS) -=item fcntl FILEHANDLE,FUNCTION,SCALAR +=item fcntl Not implemented. (Win32, VMS) -=item flock FILEHANDLE,OPERATION +=item flock Not implemented (S, VMS, S, VOS). @@ -1655,7 +1647,7 @@ Does not automatically flush output handles on some platforms. Not implemented. (S, S) -=item getpgrp PID +=item getpgrp Not implemented. (S, Win32, VMS, S) @@ -1663,43 +1655,43 @@ Not implemented. (S, Win32, VMS, S) Not implemented. (S, Win32, S) -=item getpriority WHICH,WHO +=item getpriority Not implemented. (S, Win32, VMS, S, VOS, VM/ESA) -=item getpwnam NAME +=item getpwnam Not implemented. (S, Win32) Not useful. (S) -=item getgrnam NAME +=item getgrnam Not implemented. (S, Win32, VMS, S) -=item getnetbyname NAME +=item getnetbyname Not implemented. (S, Win32, S) -=item getpwuid UID +=item getpwuid Not implemented. (S, Win32) Not useful. (S) -=item getgrgid GID +=item getgrgid Not implemented. (S, Win32, VMS, S) -=item getnetbyaddr ADDR,ADDRTYPE +=item getnetbyaddr Not implemented. (S, Win32, S) -=item getprotobynumber NUMBER +=item getprotobynumber Not implemented. (S) -=item getservbyport PORT,PROTO +=item getservbyport Not implemented. (S) @@ -1732,19 +1724,19 @@ Not implemented. (S, Win32, S) Not implemented. (Win32, S) -=item sethostent STAYOPEN +=item sethostent Not implemented. (S, Win32, S, S) -=item setnetent STAYOPEN +=item setnetent Not implemented. (S, Win32, S, S) -=item setprotoent STAYOPEN +=item setprotoent Not implemented. (S, Win32, S, S) -=item setservent STAYOPEN +=item setservent Not implemented. (S, Win32, S) @@ -1776,8 +1768,6 @@ Not implemented. (S, Win32) Not implemented. (S) -=item glob EXPR - =item glob This operator is implemented via the File::Glob extension on most @@ -1792,7 +1782,7 @@ in the Winsock API does. (Win32) Available only for socket handles. (S) -=item kill SIGNAL, LIST +=item kill C is implemented for the sake of taint checking; use with other signals is unimplemented. (S) @@ -1806,7 +1796,7 @@ and makes it exit immediately with exit status $sig. As in Unix, if $sig is 0 and the specified process exists, it returns true without actually terminating it. (Win32) -=item link OLDFILE,NEWFILE +=item link Not implemented. (S, MPE/iX, VMS, S) @@ -1816,29 +1806,23 @@ Link count not updated because hard links are not quite that hard Hard links are implemented on Win32 (Windows NT and Windows 2000) under NTFS only. -=item lstat FILEHANDLE - -=item lstat EXPR - =item lstat Not implemented. (VMS, S) Return values (especially for device and inode) may be bogus. (Win32) -=item msgctl ID,CMD,ARG +=item msgctl -=item msgget KEY,FLAGS +=item msgget -=item msgsnd ID,MSG,FLAGS +=item msgsnd -=item msgrcv ID,VAR,SIZE,TYPE,FLAGS +=item msgrcv Not implemented. (S, Win32, VMS, S, S, VOS) -=item open FILEHANDLE,EXPR - -=item open FILEHANDLE +=item open The C<|> variants are supported only if ToolServer is installed. (S) @@ -1848,21 +1832,19 @@ open to C<|-> and C<-|> are unsupported. (S, Win32, S) Opening a process does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX) -=item pipe READHANDLE,WRITEHANDLE +=item pipe Very limited functionality. (MiNT) -=item readlink EXPR - =item readlink Not implemented. (Win32, VMS, S) -=item rename OLDNAME,NEWNAME +=item rename Can't move directories between directories on different logical volumes. (Win32) -=item select RBITS,WBITS,EBITS,TIMEOUT +=item select Only implemented on sockets. (Win32, VMS) @@ -1870,11 +1852,11 @@ Only reliable on sockets. (S) Note that the C