#48999 [Opn->Csd]: flock() blocking documentation

ID: 48999 Updated by: danbrown@php.net Reported By: aharvey@php.net -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Irrelevant PHP Version: Irrelevant 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. Integrated. Thanks! Previous Comments: ------------------------------------------------------------------------ [2009-07-23 02:53:22] svn@php.net Automatic comment from SVN on behalf of danbrown Revision: http://svn.php.net/viewvc/?view=revision&revision=284629 Log: Incorporates suggested change by aharvey@php.net as noted in Bug #48999. ------------------------------------------------------------------------ [2009-07-21 09:49:14] aharvey@php.net Description: ------------ The documentation for flock() only hints that the default behaviour is blocking in the description of the operation parameter. Based on the conversation I just had in ##php, this may be confusing to people. :) For clarity, may I suggest changing the third line of the description from: PHP supports a portable way of locking complete files in an advisory way (which means all accessing programs have to use the same way of locking or it will not work). To something like: PHP supports a portable way of locking complete files in an advisory way (which means all accessing programs have to use the same way of locking or it will not work). By default, this function will block until the requested lock is acquired; this may be controlled (on non-Windows platforms) with the LOCK_NB option documented below. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=48999&edit=1