Doc #51834 [Bgs]: shorthand notation states 1 kilobyte = 1024 bytes

From: Date: Sun, 13 Jun 2010 19:35:59 +0000
Subject: Doc #51834 [Bgs]: shorthand notation states 1 kilobyte = 1024 bytes
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-4543@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=51834&edit=1 ID: 51834 User updated by: alexc223 at googlemail dot com Reported by: alexc223 at googlemail dot com Summary: shorthand notation states 1 kilobyte = 1024 bytes Status: Bogus Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant New Comment: Replace all 'kibibyte' with 'kilobyte' in the third paragraph of my previous comment, sorry typos on my part. Previous Comments: ------------------------------------------------------------------------ [2010-06-13 20:44:28] 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 20:37:14] rasmus@php.net By the way, since you are being pedantic, it is "affected" not "effected" in that context. ------------------------------------------------------------------------ [2010-06-13 20:35:54] 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:31:22] 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:26:11] 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? ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/bug.php?id=51834 -- Edit this bug report at http://bugs.php.net/bug.php?id=51834&edit=1

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