Doc #51834 [Bgs]: shorthand notation states 1 kilobyte = 1024 bytes
| From: | alexc223 at googlemail dot com | 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