#49720 [NEW]: mysql_unbuffered_query Description misleading.

From: Date: Wed, 30 Sep 2009 03:40:22 +0000
Subject: #49720 [NEW]: mysql_unbuffered_query Description misleading.
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-2838@lists.php.net to get a copy of this message
From: nmrugg at gmail dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: mysql_unbuffered_query Description misleading. Description: ------------ The manual states the following: "On the one hand, this saves a considerable amount of memory with SQL queries that produce large result sets. On the other hand, you can start working on the result set immediately after the first row has been retrieved:" The problem is that both "this saves a considerable amount of memory" and "you can start working on the result set immediately" are both good things. In English grammar, the use of "on the one hand...on the other..." indicates two opposite points. For more information on this English grammatical construction, you can check out this link: http://books.google.com/books?id=ygyFbU8h4BUC&lpg=PA153&ots=i7iduHFK82&dq=%22one%20hand%22%20%22other%20hand%22&pg=PA153#v=onepage&q=&f=false Reproduce code: --------------- --- From manual page: function.mysql-unbuffered-query#Description --- Expected result: ---------------- I suggest the paragraph should be changed to something like the following: "This saves a considerable amount of memory with SQL queries that produce large result sets, and you can start working on the result set immediately after the first row has been retrieved:" -- Edit bug report at http://bugs.php.net/?id=49720&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=49720&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=49720&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=49720&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=49720&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=49720&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=49720&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=49720&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=49720&r=needscript Try newer version: http://bugs.php.net/fix.php?id=49720&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=49720&r=support Expected behavior: http://bugs.php.net/fix.php?id=49720&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=49720&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=49720&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=49720&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=49720&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=49720&r=dst IIS Stability: http://bugs.php.net/fix.php?id=49720&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=49720&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=49720&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=49720&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=49720&r=mysqlcfg

« previous php.doc.bugs (#2838) next »