Re: [PATCH] Bring Time::Local to 1.07

[p5sagit/p5-mst-13.2.git] / pod / perlport.pod

diff --git a/pod/perlport.pod b/pod/perlport.pod
index a92e4aa..6052481 100644 (file)
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -192,8 +192,8 @@ There may well be others.  For example, on an EBCDIC implementation
 such as z/OS (OS/390) or OS/400 (using the ILE, the PASE is ASCII-based)
 the above material is similar to "Unix" but the code numbers change:
 
-    LF  eq  \025  eq  \x15  eq           chr(21)  eq  CP-1047 21
-    LF  eq  \045  eq  \x25  eq  \cU  eq  chr(37)  eq  CP-0037 37
+    LF  eq  \025  eq  \x15  eq  \cU  eq  chr(21)  eq  CP-1047 21
+    LF  eq  \045  eq  \x25  eq           chr(37)  eq  CP-0037 37
     CR  eq  \015  eq  \x0D  eq  \cM  eq  chr(13)  eq  CP-1047 13
     CR  eq  \015  eq  \x0D  eq  \cM  eq  chr(13)  eq  CP-0037 13
 
@@ -487,6 +487,20 @@ To convert $Config{perlpath} to a file pathname, say:
   if ($^O ne 'VMS')
      {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;}
 
+=head2 Networking
+
+Don't assume that you can reach the public Internet.
+
+Don't assume that there is only one way to get through firewalls
+to the public Internet.
+
+Don't assume that you can reach yourself or any node by the name
+'localhost'.  The same goes for '127.0.0.1'.
+
+Don't assume that any particular port (service) will respond.
+
+Don't assume that you can ping hosts and get replies.
+
 =head2 Interprocess Communication (IPC)
 
 In general, don't directly access the system in code meant to be
@@ -600,6 +614,9 @@ The value for C<$offset> in Unix will be C<0>, but in Mac OS will be
 some large number.  C<$offset> can then be added to a Unix time value
 to get what should be the proper value on any system.
 
+On Windows (at least), you shouldn't pass a negative value to C<gmtime> or
+C<localtime>.
+
 =head2 Character sets and character encoding
 
 Assume very little about character sets.
@@ -2102,40 +2119,43 @@ available at http://www.cpan.org/src/index.html
 
         AIX
         BeOS
+        BSD/OS          (BSDi)
         Cygwin
         DG/UX
         DOS DJGPP       1)
         DYNIX/ptx
         EPOC R5
         FreeBSD
+        HI-UXMPP        (Hitachi) (5.8.0 worked but we didn't know it)
         HP-UX
         IRIX
         Linux
         Mac OS Classic
-        Mac OS X         (Darwin)
+        Mac OS X        (Darwin)
         MPE/iX
         NetBSD
         NetWare
         NonStop-UX
-        ReliantUNIX     (SINIX)
+        ReliantUNIX     (formerly SINIX)
         OpenBSD
-        OpenVMS         (VMS)
+        OpenVMS         (formerly VMS)
+        Open UNIX       (Unixware) (since Perl 5.8.1/5.9.0)
         OS/2
         OS/400          (using the PASE) (since Perl 5.8.1/5.9.0)
         PowerUX
-        POSIX-BC        (BS2000)
+        POSIX-BC        (formerly BS2000)
         QNX
         Solaris
         SunOS 4
-        SUPER-UX
-        Tru64 UNIX      (DEC OSF/1, Digital UNIX)
+        SUPER-UX        (NEC)
+        Tru64 UNIX      (formerly DEC OSF/1, Digital UNIX)
         UNICOS
         UNICOS/mk
         UTS
         VOS
         Win95/98/ME/2K/XP 2)
         WinCE
-        z/OS            (OS/390)
+        z/OS            (formerly OS/390)
         VM/ESA
 
         1) in DOS mode either the DOS or OS/2 ports can be used