php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #51978 grammar error
Submitted: 2010-06-02 20:19 UTC Modified: 2010-06-02 20:45 UTC
From: johncburr at hotmail dot com Assigned: degeberg (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: NA
Private report: No CVE-ID: None
View Developer Edit
 [2010-06-02 20:19 UTC] johncburr at hotmail dot com 
Description:
------------
I understand that, despite the OFFICIAL ISO standard in this regard, there is a 
great debate regarding the correct pronunciation of the acronym, "SQL".  While 
some vendors prefer to pronounce it, "see kwel", MySQL OFFICIALLY pronounces it 
"ess cue el" and all documentation for MySQL should reflect that.

Therefore, the phrase, "A SQL statement..." is poor grammar.  It should read, "An 
SQL statement..." and so forth.

Frankly, the ISO officially pronounces it the same way that MySQL does and so the 
mispronunciation, "see kwel", is an indication of an individual who is uninformed 
regardless of their position in the industry.  We programmers do, after all, live 
or die by our ability to adapt to the current standards.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-06-02 20:28 UTC] degeberg@php.net 
What are you talking about?
 [2010-06-02 20:34 UTC] degeberg@php.net
-Status: Open +Status: Feedback
 [2010-06-02 20:34 UTC] degeberg@php.net 
Ah, I see what you mean now. Where do you see the phrase "A SQL statement" though?

daniel@daniel-laptop:~/projects/phpdoc/en$ ack 'An?\s+SQL'
reference/mssql/functions/mssql-query.xml
32:       A SQL query.

reference/mysql/functions/mysql-query.xml
32:       A SQL query

reference/ibm_db2/functions/db2-exec.xml
56:       An SQL statement. The statement cannot contain any parameter markers.

reference/ibm_db2/functions/db2-prepare.xml
81:       An SQL statement, optionally containing one or more parameter markers..
 [2010-06-02 20:35 UTC] rasmus@php.net
-Status: Feedback +Status: Open
 [2010-06-02 20:35 UTC] rasmus@php.net 
He is talking about "an sql" vs. "a sql".  And I agree with him, we should be 
using "an sql" everywhere.
 [2010-06-02 20:45 UTC] degeberg@php.net 
Automatic comment from SVN on behalf of degeberg
Revision: http://svn.php.net/viewvc/?view=revision&revision=300101
Log: Fixed PHP bug #51978

for file in `ack -i '\bA\s+SQL' -l`; do perl -i -pe 's/\b(a)(\s+SQL)/\1n\2/gi' $file; done
 [2010-06-02 20:45 UTC] degeberg@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: degeberg
 [2010-06-02 20:45 UTC] degeberg@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 14:00:02 2026 UTC