X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlport.pod;h=c04528bb778b7bf6d07a460385a490cc04496212;hb=593b9c1462e1fc8a2425e215f64b2197e1bfb796;hp=c6f0c4a64342e2f8abdf611b9b9b9e095b932c21;hpb=932f293e96b6dc4df3c34cd2faff050d6cfaca84;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perlport.pod b/pod/perlport.pod
index c6f0c4a..c04528b 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -497,19 +497,28 @@ to the public Internet.
 Don't assume that you can reach outside world through any other port
 than 80, or some web proxy.  ftp is blocked by many firewalls.
 
+Don't assume that you can send email by connecting to the local SMTP port.
+
 Don't assume that you can reach yourself or any node by the name
-'localhost'.  The same goes for '127.0.0.1'.  You will have to try
-both.
+'localhost'.  The same goes for '127.0.0.1'.  You will have to try both.
 
-Don't assume that the host has only network card, or that it can't
-bind to many virtual IP addresses.
+Don't assume that the host has only one network card, or that it
+can't bind to many virtual IP addresses.
 
 Don't assume a particular network device name.
 
-Don't assume that any particular port (service) will respond.
+Don't assume a particular set of ioctl()s will work.
 
 Don't assume that you can ping hosts and get replies.
 
+Don't assume that any particular port (service) will respond.
+
+Don't assume that Sys::Hostname() (or any other API or command)
+returns either a fully qualified hostname or a non-qualified hostname:
+it all depends on how the system had been configured.  Also remember
+things like DHCP and NAT-- the hostname you get back might not be very
+useful.
+
 All the above "don't":s may look daunting, and they are -- but the key
 is to degrade gracefully if one cannot reach the particular network
 service one wants.  Croaking or hanging do not look very professional.