#48999 [NEW]: flock() blocking documentation

From: aharvey@php.net Operating system: Irrelevant PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: flock() blocking documentation 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 bug report at http://bugs.php.net/?id=48999&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=48999&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=48999&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=48999&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=48999&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=48999&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=48999&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=48999&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=48999&r=needscript Try newer version: http://bugs.php.net/fix.php?id=48999&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=48999&r=support Expected behavior: http://bugs.php.net/fix.php?id=48999&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=48999&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=48999&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=48999&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=48999&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=48999&r=dst IIS Stability: http://bugs.php.net/fix.php?id=48999&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=48999&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=48999&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=48999&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=48999&r=mysqlcfg