Doc #55572 [Opn->Csd]: socket_set_nonblock description unclear
| From: | nikic@php.net | Date: | Tue, 13 Sep 2011 18:48:06 +0000 |
| Subject: | Doc #55572 [Opn->Csd]: socket_set_nonblock description unclear | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-7189@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=55572&edit=1
ID: 55572
Updated by: nikic@php.net
Reported by: php at menace dot co dot nz
Summary: socket_set_nonblock description unclear
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Documentation problem
PHP Version: 5.3.8
-Assigned To:
+Assigned To: nikic
Block user comment: N
Private report: N
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation better.
===
I added the missing "will", but I left the second sentence as-is, as I think it's
clearer the way it is now.
Previous Comments:
------------------------------------------------------------------------
[2011-09-13 18:46:32] nikic@php.net
Automatic comment from SVN on behalf of nikic
Revision: http://svn.php.net/viewvc/?view=revision&revision=316681
Log: Fix Doc Bug #55572: socket_set_nonblock description unclear
------------------------------------------------------------------------
[2011-09-02 10:24:29] php at menace dot co dot nz
Description:
------------
---
From manual page: http://www.php.net/function.socket-set-nonblock%23Description
---
<quote>When an operation (e.g. receive, send, connect, accept, ...) is performed on a
non-blocking socket, the script not pause its execution until it receives a signal or it can perform
the operation. Rather, if the operation would result in a block, the called function will fail.
</quote>
The sentence isn't clear and requires some revised grammar.
Expected result:
----------------
When an operation (e.g. receive, send, connect, accept, ...) is performed on a non-blocking socket,
the script will not pause its execution until it receives a signal or it can perform the operation.
If the operation results in a blocked socket the function will fail.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=55572&edit=1