Should this function have &warn.experimental.func;?

Derek Ford wrote:

derek Thu Jan 29 15:33:36 2004 EDT

Modified files: /phpdoc/en/reference/sockets/functions socket-set-block.xml Log:
Adding Documentation
http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/functions/socket-set-block.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/sockets/functions/socket-set-block.xml
diff -u phpdoc/en/reference/sockets/functions/socket-set-block.xml:1.1 phpdoc/en/reference/sockets/functions/socket-set-block.xml:1.2
--- phpdoc/en/reference/sockets/functions/socket-set-block.xml:1.1 Thu May 29 15:45:29 2003
+++ phpdoc/en/reference/sockets/functions/socket-set-block.xml Thu Jan 29 15:33:36 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<refentry id="function.socket-set-block">
<refnamediv>
<refname>socket_set_block</refname>
@@ -13,9 +13,38 @@
<type>bool</type><methodname>socket_set_block</methodname>
<methodparam><type>resource</type><parameter>socket</parameter></methodparam>
</methodsynopsis>
- - &warn.undocumented.func;
- + <para>
+ The <function>socket_set_block</function> function removes the O_NONBLOCK flag + on the socket specified by the <parameter>socket</parameter> parameter.
+ </para>
+ <para>
+ <example>
+ <title><function>socket_set_block</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$port = 9090;
+if(!$socket = socket_create_listen($port))
+{
+ echo socket_strerror(socket_last_error());
+}
+if(!socket_set_option($socket, SOL_SOCKET, SO_REUSEADDR, 1))
+{
+ echo socket_strerror(socket_last_error());
+}
+if(!socket_set_nonblock($socket)) //Socket $socket is now nonblocking
+{
+ echo socket_strerror(socket_last_error());
+}
+if(!socket_set_block($socket)) //Socket $socket is now blocking
+{
+ echo socket_strerror(socket_last_error());
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
<para>
&return.success;
</para>



.





Reply via email to