php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #51834 shorthand notation states 1 kilobyte = 1024 bytes
Submitted: 2010-05-16 15:48 UTC Modified: 2010-09-16 02:13 UTC
From: alexc223 at googlemail dot com Assigned: philip (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: alexc223 at googlemail dot com
New email:
PHP Version: OS:

 

 [2010-05-16 15:48 UTC] alexc223 at googlemail dot com
Description:
------------
Within the documentation, the FAQs state that shorthand notation uses 'K' for 
Kilobytes which further goes on to state that 1 Kilobyte equals 1024 bytes. This 
is incorrect as 1 kilobyte actually equals 1000 bytes. 1 Kibibyte is equal to 
1024, not kilobyte.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-05-16 20:41 UTC] johannes@php.net
-Status: Open +Status: Bogus
 [2010-05-16 20:41 UTC] johannes@php.net
You might be correct from a scientifical or theoretical point if view. In real world average users expect a "kilobyte" to be 1024 bytes.
 [2010-05-16 20:55 UTC] alexc223 at googlemail dot com
I disagree, many users don't even know that 'kB' and 'KiB' are different things 
but 
instead there is just 'kb' to them (I have no factual evidence to support this, 
however that is what can normally be seen from real-world users), therefore 
they're 
not going to know that a kilobyte should be 1024 bytes or 1000 bytes.

The documentation should reflect the correct term and/or value - since this has 
caused me quite a bit of confusing when reading over it. It stated it 'K' was 
for 
Kilobyte but has a value of 1024; what is the correct meaning of 'K'? It has to 
be 
one or the other.
 [2010-05-17 15:50 UTC] foutrelis at gmail dot com
I agree with the submitter; the correct name (kibibyte) should be used to denote 
1024 bytes. Some people do know the difference between the SI and IEC prefixes 
and this can confuse them. For the people that don't know, it's an opportunity to 
learn about this.
 [2010-05-30 14:45 UTC] alexc223 at googlemail dot com
Can we get an update on this? I don't feel this bug report has been handled with 
much communication to resolve an issue that clearly exists, but is being ignored 
even though you agree it is a bug.

It's not a bogus bug.
 [2010-06-13 20:12 UTC] artificial at iol dot ie
Just because some standards body wants to redefine words does not change how 98% of people use those words.

People who say kibibyte = libtards.
 [2010-06-13 20:26 UTC] alexc223 at googlemail dot com
Where are you getting this 98% from? It's just air facts. Everyone so far has 
agreed this bug exists, yet are refusing to change 1 simple word for no reason at 
all.

Is it even worth reporting bugs against PHP documentation?
 [2010-06-13 20:31 UTC] alexc223 at googlemail dot com
Just to reiterate, I'm not asking to change the value of K, just to change the 
wording. No code will be effected by changing this.
 [2010-06-13 20:35 UTC] rasmus@php.net
There is one comment that agrees with you on this bug.  Saying "Everyone" here is 
rather overstating things, don't you think?  Nobody is arguing that it isn't 
technically correct, but in the real world, people don't actually know what a 
kibibyte is.  I have taken a couple of quick straw polls of the audience at my 
various PHP talks and typically there are 1 or 2 people in an audience of 50 who 
know what it is.  The PHP documentation is not the place for evangelizing this.
 [2010-06-13 20:37 UTC] rasmus@php.net
By the way, since you are being pedantic, it is "affected" not "effected" in that 
context.
 [2010-06-13 20:44 UTC] alexc223 at googlemail dot com
For 'everyone' sorry I was referring to the mailing list discussion regarding this 
bug.

But surely those that don't know what a kibibyte is can (like I've said in the 
mailing list) A) keep reading to see the value mentioned (as the PHP documentation 
does currently or B) Google what a kibibyte is. Anyone with half a braincell could 
do either.

All this does is add confusion for those that know the difference and expect the 
value of kibibyte to *be* the value of a kibibyte, not what ever PHP decides a 
kibibyte should be. I see 100% no reason for the documentation to directly use the 
wrong *word* when using the correct word would not affect (thank you for the 
correction...).

I'm not saying change the value, just 1, simple word.
 [2010-06-13 21:35 UTC] alexc223 at googlemail dot com
Replace all 'kibibyte' with 'kilobyte' in the third paragraph of my previous 
comment, sorry typos on my part.
 [2010-09-16 02:12 UTC] philip@php.net
Automatic comment from SVN on behalf of philip
Revision: http://svn.php.net/viewvc/?view=revision&revision=303411
Log: Added information about kibibyte vs kilobyte. Closes PHP bug #51834
 [2010-09-16 02:13 UTC] philip@php.net
-Status: Bogus +Status: Closed -Assigned To: +Assigned To: philip
 [2010-09-16 02:13 UTC] philip@php.net
I added a few words on the subject.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Tue May 21 11:01:34 2024 UTC