php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #49720 mysql_unbuffered_query Description misleading.
Submitted: 2009-09-30 03:40 UTC Modified: 2009-09-30 06:43 UTC
From: nmrugg at gmail dot com Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
 [2009-09-30 03:40 UTC] 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:"




Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2009-09-30 06:43 UTC] 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 06:43 UTC] torben@php.net
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.


 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Thu Oct 08 07:00:01 2026 UTC