diff --git a/functions/network.xml b/functions/network.xml
index 96d3d5909a..c017fe2153 100644
--- a/functions/network.xml
+++ b/functions/network.xml
@@ -135,17 +135,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-	 Initiates a stream connection in the Internet (AF_INET, using
-	 TCP or UDP) or Unix (AF_UNIX) domain. For the Internet domain, 
-	 it will open a TCP
-	 socket connection to <parameter>hostname</parameter> on
-	 port <parameter>port</parameter>. For UDP connections, you need
-	 to explicitely specify the the protocol:
-	 <parameter>udp://hostname</parameter>.  For the Unix domain,
-	 <parameter>hostname</parameter> will be used as the path to the
-	 socket, <parameter>port</parameter> must be set to 0 in this
-	 case.  The optional <parameter>timeout</parameter> can be used
-	 to set a timeout in seconds for the connect system call.
+	 Initiates a stream connection in the Internet (AF_INET, using TCP
+	 or UDP) or Unix (AF_UNIX) domain. For the Internet domain, it
+	 will open a TCP socket connection to
+	 <parameter>hostname</parameter> on port
+	 <parameter>port</parameter>.  <parameter>hostname</parameter> may
+	 in this case be either a fully qualified domain name or an IP
+	 address. For UDP connections, you need to explicitely specify the
+	 the protocol: <parameter>udp://hostname</parameter>.  For the
+	 Unix domain, <parameter>hostname</parameter> will be used as the
+	 path to the socket, <parameter>port</parameter> must be set to 0
+	 in this case.  The optional <parameter>timeout</parameter> can be
+	 used to set a timeout in seconds for the connect system call.
     </para>
     <para>
      <function>Fsockopen</function> returns a file pointer which may