#49720 [Opn->Csd]: mysql_unbuffered_query Description misleading.

ID: 49720 Updated by: torben@php.net Reported By: nmrugg at gmail dot com -Status: Open +Status: Closed Bug Type: Documentation problem 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. Previous Comments: ------------------------------------------------------------------------ [2009-09-30 06:43:32] svn@php.net Automatic comment from SVN on behalf of torben Revision: http://svn.php.net/viewvc/?view=revision&revision=288979 Log: Various grammatical fixes. Addresses bug #49720. ------------------------------------------------------------------------ [2009-09-30 03:40:21] nmrugg at gmail dot com 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 this bug report at http://bugs.php.net/?id=49720&edit=1