mfischer                Tue Apr 30 17:27:51 2002 EDT

  Modified files:              
    /phpdoc/en/reference/sockets        reference.xml 
  Log:
  - Expand introduction a bit
  
  
Index: phpdoc/en/reference/sockets/reference.xml
diff -u phpdoc/en/reference/sockets/reference.xml:1.2 
phpdoc/en/reference/sockets/reference.xml:1.3
--- phpdoc/en/reference/sockets/reference.xml:1.2       Mon Apr 15 17:57:22 2002
+++ phpdoc/en/reference/sockets/reference.xml   Tue Apr 30 17:27:50 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
  <reference id="ref.sockets">
   <title>Socket functions</title>
   <titleabbrev>Sockets</titleabbrev>
@@ -7,9 +7,9 @@
   <partintro>
    &warn.experimental;
    <simpara>
-    The socket extension implements a low-level interface to the
-    socket communication functions, providing the possibility to act
-    as a socket server as well as a client.
+    The socket extension implements a low-level interface to the socket
+    communication functions based on the popular BSD sockets, providing the
+    possibility to act as a socket server as well as a client.
    </simpara>
    <para>
     The socket functions described here are part of an extension to
@@ -29,11 +29,40 @@
     descriptions to avoid confusion.
    </para>
    <para>
-    That said, those unfamiliar with socket programming can still find
-    a lot of useful material in the appropriate Unix man pages, and
-    there is a great deal of tutorial information on socket
-    programming in C on the web, much of which can be applied, with
-    slight modifications, to socket programming in PHP.
+    The socket extension was written to provide a useable interface to the
+    powerful BSD sockets. Care has been taken that the functions work equaly
+    well on Win32 and Unix implementations. Almost all of the sockets
+    functions may fail under certain conditions and therefore emit an
+    <literal>E_WARNING</literal> message describing the error. Sometimes this
+    doesn't happen to the desire of the developer. For example the function
+    <function>socket_read</function> may suddenly emit an
+    <literal>E_WARNING</literal> message because the connection broke
+    unexpectedly. It's common to suppress the warning with the
+    <literal>@</literal>-operator and catch the error code within the
+    application with the <function>socket_last_error</function> function. You
+    may call the <function>socket_strerror</function> function with this error
+    code to retrieve a string describing the error. See their description for
+    more information.
+   </para>
+   <note>
+    <para>
+     The <literal>E_WARNING</literal> messages generated by the socket
+     extension are in english though the retrieved error message will appear
+     depending on the current locale (<literal>LC_MESSAGES</literal>):
+     <programlisting role="php">
+<![CDATA[
+Warning - socket_bind() unable to bind address [98]: Die Adresse wird bereits 
+verwendet
+]]>
+     </programlisting>
+    </para>
+   </note>
+   <para>
+    That said, those unfamiliar with socket programming can still find a lot
+    of useful material in the appropriate Unix man pages, and there is a great
+    deal of tutorial information on socket programming in C on the web, much
+    of which can be applied, with slight modifications, to socket programming
+    in PHP. The <ulink url="http://www.developerweb.net/sock-faq/";>UNIX Socket
+    FAQ</ulink> might be a good start.
    </para>
    <para>
     <example>


Reply via email to