show sizes in unambiguous way that doesn't get mistaken for different units #964

Open
opened 2010-02-20 23:42:55 +00:00 by USSJoin · 14 comments
USSJoin commented 2010-02-20 23:42:55 +00:00
Owner

When setting up a storage node, it took me a long time to figure out why the storage wasn't respecting my set 15GB of reserved space on the drive. I finally realized that like hard drive manufacturers but unlike the rest of the planet, Tahoe is counting size in base-10, not base-2-- so kilobytes are 1000 bytes, not 1024, and so on. This leads to reports from Tahoe being dramatically different than, say, df -h, and thus creates confusion.

When setting up a storage node, it took me a long time to figure out why the storage wasn't respecting my set 15GB of reserved space on the drive. I finally realized that *like* hard drive manufacturers but *unlike* the rest of the planet, Tahoe is counting size in base-10, not base-2-- so kilobytes are 1000 bytes, not 1024, and so on. This leads to reports from Tahoe being *dramatically* different than, say, `df -h`, and thus creates confusion.
tahoe-lafs added the
c/code-storage
p/minor
t/defect
v/1.6.0
labels 2010-02-20 23:42:55 +00:00
tahoe-lafs added this to the undecided milestone 2010-02-20 23:42:55 +00:00

A good way out of this mess is to spell it out explicitly -- write "2^30^" or "10^9^" or "one billion".

See also:
http://en.wikipedia.org/wiki/Binary_prefix

A good way out of this mess is to spell it out explicitly -- write "2^30^" or "10^9^" or "one billion". See also: <http://en.wikipedia.org/wiki/Binary_prefix>

Hitherto I believe we've been using "GiB" to mean 2^30^ (per http://en.wikipedia.org/wiki/Binary_prefix ) and we may have sometimes been using "GB" to mean 10^9^. That latter usage, while technically correct, and accurate and meaningful to the vast majority of users (who do base-10 arithmetic in their heads but not base-2 arithmetic), is confusing to hackers like USSJoin. So we should avoid it, possibly by replacing uses of "GB" with "10^9^".

Hitherto I believe we've been using "GiB" to mean 2^30^ (per <http://en.wikipedia.org/wiki/Binary_prefix> ) and we may have sometimes been using "GB" to mean 10^9^. That latter usage, while technically correct, and accurate and meaningful to the vast majority of users (who do base-10 arithmetic in their heads but not base-2 arithmetic), is confusing to hackers like USSJoin. So we should avoid it, possibly by replacing uses of "GB" with "10^9^".
USSJoin commented 2010-02-21 01:35:37 +00:00
Author
Owner

Alternately, you could simply use GiB consistently everywhere (for instance, on the storage information page) and do the units as GiB, not 10^9. That way people don't have to go "what's a 10^9?" when looking at information pages.

Alternately, you could simply use GiB consistently everywhere (for instance, on the storage information page) and do the units *as* GiB, not 10^9. That way people don't have to go "what's a 10^9?" when looking at information pages.

We generally prefer base-10 arithmetic, because it is easier for users to use. For example, if you ask my mom how many 20-byte things she can store in a 2-terabyte bucket, she'll probably ask "What's a terabyte?", and if you tell her it is a trillion bytes, she'll say "Then I can store 100 billion of them.". If instead you tell her that it is 2^40^ bytes, then she'll either have to get out a calculator or she'll just give up.
In fact, I strongly suspect that a similar problem applies to computer hackers as well as to moms. Quick, how many 20-byte things can you store in a bucket of size 2^41^ bytes (two TiB)? I think it will take you longer to answer that question that it would take my mom to answer the base-10 variant of the question.
If you answered "about a hundred billion of them" then your answer was 10% off!
Back when our buckets were on the order of thousands of elements in size, the approximation of 2^10^≅10^3^ was only 2.5% off. The approximation of 2^20^≅10^6^ is 5% off, 2^30^≅10^9^ is 7.5% off, and 2^40^≅10^12^ is 10% off.
By the way, Apple products now report file sizes and filesystem spaces in base-10: http://support.apple.com/kb/TS2419

We generally prefer base-10 arithmetic, because it is easier for users to use. For example, if you ask my mom how many 20-byte things she can store in a 2-terabyte bucket, she'll probably ask "What's a terabyte?", and if you tell her it is a trillion bytes, she'll say "Then I can store 100 billion of them.". If instead you tell her that it is 2^40^ bytes, then she'll either have to get out a calculator or she'll just give up. In fact, I strongly suspect that a similar problem applies to computer hackers as well as to moms. Quick, how many 20-byte things can you store in a bucket of size 2^41^ bytes (two [TiB](http://en.wikipedia.org/wiki/Tebibyte))? I think it will take you longer to answer that question that it would take my mom to answer the base-10 variant of the question. If you answered "about a hundred billion of them" then your answer was 10% off! Back when our buckets were on the order of thousands of elements in size, the approximation of 2^10^≅10^3^ was only 2.5% off. The approximation of 2^20^≅10^6^ is 5% off, 2^30^≅10^9^ is 7.5% off, and 2^40^≅10^12^ is 10% off. By the way, Apple products now report file sizes and filesystem spaces in base-10: <http://support.apple.com/kb/TS2419>

We're with USSJoin on this. Resist the hard disk manufacturers' conspiracy.

Replying to zooko:

We generally prefer base-10 arithmetic, because it is easier for users to use. For example, if you ask my mom how many 20-byte things she can store in a 2-terabyte bucket, she'll probably ask "What's a terabyte?", and if you tell her it is a trillion bytes, she'll say "Then I can store 100 billion of them."

This is not a convincing argument, since you're more likely to need to know how many 1 MiB files, say, can be stored in a terabyte. (BTW, your mom's estimate would be wildly wrong for 20-byte files due to overhead.)

What mattered was that there was a consistent convention. Since most uses of "GB" (for example) still mean 2^30 bytes, Tahoe is going in the wrong direction to reduce confusion.

We're with USSJoin on this. Resist the hard disk manufacturers' conspiracy. Replying to [zooko](/tahoe-lafs/trac/issues/964#issuecomment-376627): > We generally prefer base-10 arithmetic, because it is easier for users to use. For example, if you ask my mom how many 20-byte things she can store in a 2-terabyte bucket, she'll probably ask "What's a terabyte?", and if you tell her it is a trillion bytes, she'll say "Then I can store 100 billion of them." This is not a convincing argument, since you're more likely to need to know how many 1 MiB files, say, can be stored in a terabyte. (BTW, your mom's estimate would be wildly wrong for 20-byte files due to overhead.) What mattered was that there was a consistent convention. Since most uses of "GB" (for example) still mean 2^30 bytes, Tahoe is going in the wrong direction to reduce confusion.
kmarkley86 commented 2010-02-22 06:44:13 +00:00
Author
Owner

People have strong reasons for strong preferences on both sides. How about making this configurable, so then we can fight about the default instead of forcing one style on everyone? (Also, base-2 sizes should be the default.)

People have strong reasons for strong preferences on both sides. How about making this configurable, so then we can fight about the default instead of forcing one style on everyone? (Also, base-2 sizes should be the default.)

/me runs into the room waving his hands madly like a muppet. nooo!

Please don't contribute to the confusion by printing "x GB" and silently
using it to mean 2^30^. The entire non-computer world, the SI, and every
dictionary on the planet knows that the metric G suffix means giga means
10^9^. And while I find "GiB" pretty funny-looking, it is an unambiguous,
learnable, and eventually-straightforward term that clearly means 2^30^.
Let's not conflate the two. Sure, this helps the hard-drive manufacturers,
but it's a terminology bugfix, not a conspiracy :).

I'm -1 on having a config option for pretending GB=2^30^: someone looking at
the web page (and not at the config file) would be unable to learn the truth.

In places where we have evidence that people want both sorts of values, we
should give them both sorts of values. For example, on the "Storage Server
Status" page, we currently show abbreviated GB (10^9^) and unabbreviated
number-of-bytes:

Total disk space:       319.73 GB       (319728959488)
Disk space used:        - 311.44 GB     (311444250624)

My hope was that the "319728959488" would look enough like the "319.73" to
cue the reader into remembering that GB means 10^9^, but the original
poster's experience suggests this failed. Some other options for that
display:

Total disk space:       319.73 GB       (319728959488) (297.77 GiB)

Total disk space:       319.73 GB(10^9) (319728959488)

Total disk space:       319.73 GB(10^9) (319728959488) 297.77 GiB(2^30)

Since this is a web page, we could also have a popup over the "319.73 GB"
line that displays a number of other formats, not unlike we recently added a
popup to Foolscap's log-web-viewer display to show timestamps in alternate
formats (UTC/local/short/long):

319728959488
319.73 GB (10^9)
297.77 GiB (2^30)

I'm -0 on having a config option that makes these pages display GiB
instead of GB, as long as it never ever tries to pretend that GB is
2^30^, and that there continues to be a full-number-of-bytes display so that
someone looking at the abbreviation has a chance to figure out what it means
and become confident in our consistent use of terms.

This is not a convincing argument, since you're more likely to need to know
how many 1 MiB files, say, can be stored in a terabyte. (BTW, your mom's
estimate would be wildly wrong for 20-byte files due to overhead.)

Huh? Except for programmer-driven test cases, I don't think there's any
particular quantization on filesizes. I'm not counting 1 MB or 1 MiB files,
I'm counting how many digital pictures I can stuff onto a disk, and they're
all sorts of random sizes. The only real quantization I can think of would be
the chapters on a ripped DVD image (according to wikipedia these are usually
1 GiB in size), but I really don't think "how many non-terminal DVD VOB files
can I fit on this disk" is a common question.

Hitherto I believe we've been using "GiB" to mean 2^30^ (per
http://en.wikipedia.org/wiki/Binary_prefix ) and we may have sometimes been
using "GB" to mean 10^9^.

We're always using GB to mean 10^9^ and GiB to mean 2^30^. I fix the
code if I discover it doing otherwise.

/me runs into the room waving his hands madly like a muppet. nooo! Please don't contribute to the confusion by printing "x GB" and silently using it to mean 2^30^. The entire non-computer world, the SI, and every dictionary on the planet knows that the metric G suffix means giga means 10^9^. And while I find "GiB" pretty funny-looking, it is an unambiguous, learnable, and eventually-straightforward term that clearly means 2^30^. Let's not conflate the two. Sure, this helps the hard-drive manufacturers, but it's a terminology bugfix, not a conspiracy :). I'm -1 on having a config option for pretending GB=2^30^: someone looking at the web page (and not at the config file) would be unable to learn the truth. In places where we have evidence that people want both sorts of values, we should give them both sorts of values. For example, on the "Storage Server Status" page, we currently show abbreviated GB (10^9^) and unabbreviated number-of-bytes: ``` Total disk space: 319.73 GB (319728959488) Disk space used: - 311.44 GB (311444250624) ``` My hope was that the "319728959488" would look enough like the "319.73" to cue the reader into remembering that GB means 10^9^, but the original poster's experience suggests this failed. Some other options for that display: ``` Total disk space: 319.73 GB (319728959488) (297.77 GiB) Total disk space: 319.73 GB(10^9) (319728959488) Total disk space: 319.73 GB(10^9) (319728959488) 297.77 GiB(2^30) ``` Since this is a web page, we could also have a popup over the "319.73 GB" line that displays a number of other formats, not unlike we recently added a popup to Foolscap's log-web-viewer display to show timestamps in alternate formats (UTC/local/short/long): ``` 319728959488 319.73 GB (10^9) 297.77 GiB (2^30) ``` I'm -0 on having a config option that makes these pages display GiB **instead** of GB, as long as it never ever tries to pretend that GB is 2^30^, and that there continues to be a full-number-of-bytes display so that someone looking at the abbreviation has a chance to figure out what it means and become confident in our consistent use of terms. > This is not a convincing argument, since you're more likely to need to know > how many 1 MiB files, say, can be stored in a terabyte. (BTW, your mom's > estimate would be wildly wrong for 20-byte files due to overhead.) Huh? Except for programmer-driven test cases, I don't think there's any particular quantization on filesizes. I'm not counting 1 MB or 1 MiB files, I'm counting how many digital pictures I can stuff onto a disk, and they're all sorts of random sizes. The only real quantization I can think of would be the chapters on a ripped DVD image (according to wikipedia these are usually 1 GiB in size), but I really don't think "how many non-terminal DVD VOB files can I fit on this disk" is a common question. > Hitherto I believe we've been using "GiB" to mean 2^30^ (per > <http://en.wikipedia.org/wiki/Binary_prefix> ) and we may have sometimes been > using "GB" to mean 10^9^. We're **always** using GB to mean 10^9^ and GiB to mean 2^30^. I fix the code if I discover it doing otherwise.

This is what people call "a bike shed". The theory goes that few people are willing to contribute their opinions about designing nuclear power plants, because that is very complex and requires high expertise, but many people are willing to contribute their opinions about designing a bike shed, because it is simple enough that they can see how they would like it to be.

(Aside: I don't really like that metaphor of a "bike shed" because it belittles the concerns of the contributors. I actually agree with USSJoin, davidsarah, and kmarkley86 that user interface issues are important, including this one. Don't forget that the original post by USSJoin explained how he actually lost some of his time due to confusion. Wasting user time is not okay! Also, a design being simple and easy to understand doesn't mean that it doesn't matter how it is done!)

However, this issue has now distracted both David-Sarah and Brian from building nuclear power plants. Let's put a stop to the discussion. Our policy will be to express numbers in units that are as unambiguous as possible so that a user who assumes that "GB" means 2^20^ and a user who assume that "GB" means 10^9^ will both have a minimal chance of wasting their time with confusion. Specifically, the suggestions that Brian made in comment:376630 about redundantly listing the same value in different units would probably help.

That's the main idea -- to make the user interface sufficiently clear (even at the cost of redundancy) that nobody wastes their time mistaking the units. I believe this policy will satisfice.

We will continue to use KiB to mean 10^3^, MiB to mean 10^6^, GiB to mean 10^9^, TiB to mean 10^12^ etc. as per http://en.wikipedia.org/wiki/Binary_prefix , and never use KB to mean 2^10^ etc.. However, as per the main idea, above, we will probably try to reduce the use of KB at all in favor of less ambiguous designations.

This is what people call ["a bike shed"](http://en.wikipedia.org/wiki/Parkinson%27s_Law_of_Triviality). The theory goes that few people are willing to contribute their opinions about designing nuclear power plants, because that is very complex and requires high expertise, but many people are willing to contribute their opinions about designing a bike shed, because it is simple enough that they can see how they would like it to be. *(Aside: I don't really like that metaphor of a "bike shed" because it belittles the concerns of the contributors. I actually agree with USSJoin, davidsarah, and kmarkley86 that user interface issues are important, including this one. Don't forget that the original post by USSJoin explained how he actually lost some of his time due to confusion. Wasting user time is not okay! Also, a design being simple and easy to understand doesn't mean that it doesn't matter how it is done!)* However, this issue has now distracted both David-Sarah and Brian from [building nuclear power plants](http://allmydata.org/trac/tahoe-lafs/milestone/2.0.0). Let's put a stop to the discussion. Our policy will be to express numbers in units that are as unambiguous as possible so that a user who assumes that "GB" means 2^20^ and a user who assume that "GB" means 10^9^ will both have a minimal chance of wasting their time with confusion. Specifically, the suggestions that Brian made in [comment:376630](/tahoe-lafs/trac/issues/964#issuecomment-376630) about redundantly listing the same value in different units would probably help. That's the main idea -- to make the user interface sufficiently clear (even at the cost of redundancy) that nobody wastes their time mistaking the units. I believe this policy will [satisfice](http://en.wikipedia.org/wiki/Satisficing). We will continue to use `KiB` to mean 10^3^, `MiB` to mean 10^6^, `GiB` to mean 10^9^, `TiB` to mean 10^12^ etc. as per <http://en.wikipedia.org/wiki/Binary_prefix> , and never use `KB` to mean 2^10^ etc.. However, as per the *main idea*, above, we will probably try to reduce the use of `KB` at all in favor of less ambiguous designations.

Replying to warner:

In places where we have evidence that people want both sorts of values, we
should give them both sorts of values. For example, on the "Storage Server
Status" page, we currently show abbreviated GB (10^9^) and unabbreviated
number-of-bytes:

Total disk space:       319.73 GB       (319728959488)
Disk space used:        - 311.44 GB     (311444250624)

My hope was that the "319728959488" would look enough like the "319.73" to
cue the reader into remembering that GB means 10^9^, but the original
poster's experience suggests this failed.

You know what? This might have worked if the bytes display had included commas, like this:

Total disk space:       319.73 GB       (319,728,959,488)
Disk space used:        - 311.44 GB     (311,444,250,624)

I don't know about USSJoin, but for me, my eyeballs just slide right off of "319728959488" after the first couple of digits.
Proposed action items to make this ticket closable:

  • change the Summary to "show sizes in unambiguous way that doesn't get mistaken for different units"
  • add commas to outputs which are in terms of bytes
  • ask people for feedback on whether this is now sufficiently clear to them
  • close the ticket as fixed
Replying to [warner](/tahoe-lafs/trac/issues/964#issuecomment-376630): > > In places where we have evidence that people want both sorts of values, we > should give them both sorts of values. For example, on the "Storage Server > Status" page, we currently show abbreviated GB (10^9^) and unabbreviated > number-of-bytes: > ``` Total disk space: 319.73 GB (319728959488) Disk space used: - 311.44 GB (311444250624) ``` > > My hope was that the "319728959488" would look enough like the "319.73" to > cue the reader into remembering that GB means 10^9^, but the original > poster's experience suggests this failed. You know what? This might have worked if the bytes display had included commas, like this: ``` Total disk space: 319.73 GB (319,728,959,488) Disk space used: - 311.44 GB (311,444,250,624) ``` I don't know about USSJoin, but for me, my eyeballs just slide right off of "319728959488" after the first couple of digits. Proposed action items to make this ticket closable: * change the Summary to "show sizes in unambiguous way that doesn't get mistaken for different units" * add commas to outputs which are in terms of bytes * ask people for feedback on whether this is now sufficiently clear to them * close the ticket as fixed
zooko changed title from List sizes for storage using base-2 sizes, not base-10 to show sizes in unambiguous way that doesn't get mistaken for different units 2010-03-25 22:32:56 +00:00
zooko self-assigned this 2010-12-22 18:51:12 +00:00

I like the commas idea: my eyeballs slide off long numbers too. My hesitation is that every once in a rare while, I cut-and-paste a number like that into a calculator or python repl, and the commas would mess that up. But I think readability trumps cut-and-pasteability. So +1 on the commas.

You might also add units: (319,728,959,488 bytes). But maybe not.

Oh, you know, there might possibly be a CSS styling thing that lets you tell the system that this is a number, and that it ought to add comma-like things according to the current locale (since they'd be periods in europe). I have a hazy memory that suggests doing this would also retain cut-and-pasteability, because the commas/periods would be purely visual: cut/paste would still get the original non-comma-ified number. Does this ring any bells for anyone, or am I completely imagining it?

I like the commas idea: my eyeballs slide off long numbers too. My hesitation is that every once in a rare while, I cut-and-paste a number like that into a calculator or python repl, and the commas would mess that up. But I think readability trumps cut-and-pasteability. So +1 on the commas. You might also add units: `(319,728,959,488 bytes)`. But maybe not. Oh, you know, there might possibly be a CSS styling thing that lets you tell the system that this is a number, and that it ought to add comma-like things according to the current locale (since they'd be periods in europe). I have a hazy memory that suggests doing this would also retain cut-and-pasteability, because the commas/periods would be purely visual: cut/paste would still get the original non-comma-ified number. Does this ring any bells for anyone, or am I completely imagining it?
ScottD commented 2010-12-28 16:56:53 +00:00
Author
Owner

The only way I know to pull off locale-formatted numbers is to use a span with a CSS-class and use javascript to read those elements using parseInt()/parseFloat() and replacing them with toLocaleString(). The locale will get picked up from whatever browser is being used and degrades nicely to plain numbers if javascript is unavailable.

The only way I know to pull off locale-formatted numbers is to use a span with a CSS-class and use javascript to read those elements using parseInt()/parseFloat() and replacing them with toLocaleString(). The locale will get picked up from whatever browser is being used and degrades nicely to plain numbers if javascript is unavailable.

Replying to ScottD:

The only way I know to pull off locale-formatted numbers is to use a span with a CSS-class and use javascript to read those elements using parseInt()/parseFloat() and replacing them with toLocaleString(). The locale will get picked up from whatever browser is being used and degrades nicely to plain numbers if javascript is unavailable.

That's not worth the complexity IMHO. Separating the digit groups with spaces, e.g.

Total disk space:       319.73 GB       (319 728 959 488 bytes)
Disk space used:        - 311.44 GB     (311 444 250 624 bytes)

is understood internationally, and personally I think it's more readable. In HTML,   (NARROW NO-BREAK SPACE) might be better.

Replying to [ScottD](/tahoe-lafs/trac/issues/964#issuecomment-376636): > The only way I know to pull off locale-formatted numbers is to use a span with a CSS-class and use javascript to read those elements using parseInt()/parseFloat() and replacing them with toLocaleString(). The locale will get picked up from whatever browser is being used and degrades nicely to plain numbers if javascript is unavailable. That's not worth the complexity IMHO. Separating the digit groups with spaces, e.g. ``` Total disk space: 319.73 GB (319 728 959 488 bytes) Disk space used: - 311.44 GB (311 444 250 624 bytes) ``` is understood internationally, and personally I think it's more readable. In HTML, &#x202f; (NARROW NO-BREAK SPACE) might be better.

Replying to zooko:

This is what people call "a bike shed". The theory goes that few people are willing to contribute their opinions about designing nuclear power plants, because that is very complex and requires high expertise, but many people are willing to contribute their opinions about designing a bike shed, because it is simple enough that they can see how they would like it to be.

(Aside: I don't really like that metaphor of a "bike shed" because it belittles the concerns of the contributors. I actually agree with USSJoin, davidsarah, and kmarkley86 that user interface issues are important, including this one. Don't forget that the original post by USSJoin explained how he actually lost some of his time due to confusion. Wasting user time is not okay! Also, a design being simple and easy to understand doesn't mean that it doesn't matter how it is done!)

However, this issue has now distracted both David-Sarah and Brian from building nuclear power plants. Let's put a stop to the discussion. Our policy will be to express numbers in units that are as unambiguous as possible so that a user who assumes that "GB" means 2^20^ and a user who assume that "GB" means 10^9^ will both have a minimal chance of wasting their time with confusion. Specifically, the suggestions that Brian made in comment:376630 about redundantly listing the same value in different units would probably help.

That's the main idea -- to make the user interface sufficiently clear (even at the cost of redundancy) that nobody wastes their time mistaking the units. I believe this policy will satisfice.

We will continue to use KiB to mean 10^3^, MiB to mean 10^6^, GiB to mean 10^9^, TiB to mean 10^12^ etc. as per http://en.wikipedia.org/wiki/Binary_prefix , and never use KB to mean 2^10^ etc.. However, as per the main idea, above, we will probably try to reduce the use of KB at all in favor of less ambiguous designations.

Oops.... isn't it KiB means 2^10^... et cetera? If I Understand Correctly the infixed "i" means base 2, and exponent increments of 10.

Replying to [zooko](/tahoe-lafs/trac/issues/964#issuecomment-376631): > This is what people call ["a bike shed"](http://en.wikipedia.org/wiki/Parkinson%27s_Law_of_Triviality). The theory goes that few people are willing to contribute their opinions about designing nuclear power plants, because that is very complex and requires high expertise, but many people are willing to contribute their opinions about designing a bike shed, because it is simple enough that they can see how they would like it to be. > > *(Aside: I don't really like that metaphor of a "bike shed" because it belittles the concerns of the contributors. I actually agree with USSJoin, davidsarah, and kmarkley86 that user interface issues are important, including this one. Don't forget that the original post by USSJoin explained how he actually lost some of his time due to confusion. Wasting user time is not okay! Also, a design being simple and easy to understand doesn't mean that it doesn't matter how it is done!)* > > However, this issue has now distracted both David-Sarah and Brian from [building nuclear power plants](http://allmydata.org/trac/tahoe-lafs/milestone/2.0.0). Let's put a stop to the discussion. Our policy will be to express numbers in units that are as unambiguous as possible so that a user who assumes that "GB" means 2^20^ and a user who assume that "GB" means 10^9^ will both have a minimal chance of wasting their time with confusion. Specifically, the suggestions that Brian made in [comment:376630](/tahoe-lafs/trac/issues/964#issuecomment-376630) about redundantly listing the same value in different units would probably help. > > That's the main idea -- to make the user interface sufficiently clear (even at the cost of redundancy) that nobody wastes their time mistaking the units. I believe this policy will [satisfice](http://en.wikipedia.org/wiki/Satisficing). > > We will continue to use `KiB` to mean 10^3^, `MiB` to mean 10^6^, `GiB` to mean 10^9^, `TiB` to mean 10^12^ etc. as per <http://en.wikipedia.org/wiki/Binary_prefix> , and never use `KB` to mean 2^10^ etc.. However, as per the *main idea*, above, we will probably try to reduce the use of `KB` at all in favor of less ambiguous designations. > Oops.... isn't it `KiB` means 2^10^... et cetera? If I Understand Correctly the infixed "i" means base 2, and exponent increments of 10.

Replying to [Zancas]comment:14:

We will continue to use KiB to mean 10^3^, MiB to mean 10^6^, GiB to mean 10^9^, TiB to mean 10^12^ etc. as per http://en.wikipedia.org/wiki/Binary_prefix , and never use KB to mean 2^10^ etc.. However, as per the main idea, above, we will probably try to reduce the use of KB at all in favor of less ambiguous designations.

Oops.... isn't it KiB means 2^10^... et cetera? If I Understand Correctly the infixed "i" means base 2, and exponent increments of 10.

Argh! How did I screw that up‽ Thanks, Zancas, for noticing. Everyone reading this: disregard what I wrote and just believe that we're going to do what http://en.wikipedia.org/wiki/Binary_prefix says about how to spell the base-2 things. Also, as previously mentioned on this ticket, spelling out numbers with commas in place is unambiguous and is the standard format for integers in Internet English writing.

Replying to [Zancas]comment:14: > > We will continue to use `KiB` to mean 10^3^, `MiB` to mean 10^6^, `GiB` to mean 10^9^, `TiB` to mean 10^12^ etc. as per <http://en.wikipedia.org/wiki/Binary_prefix> , and never use `KB` to mean 2^10^ etc.. However, as per the *main idea*, above, we will probably try to reduce the use of `KB` at all in favor of less ambiguous designations. > > Oops.... isn't it `KiB` means 2^10^... et cetera? If I Understand Correctly the infixed "i" means base 2, and exponent increments of 10. Argh! How did I screw that up‽ Thanks, Zancas, for noticing. Everyone reading this: disregard what I wrote and just believe that we're going to do what <http://en.wikipedia.org/wiki/Binary_prefix> says about how to spell the base-2 things. Also, as previously mentioned [on this ticket](/tahoe-lafs/trac/issues/964#issuecomment-376635), spelling out numbers with commas in place is unambiguous and is the standard format for integers in Internet English writing.
Sign in to join this conversation.
No labels
c/code
c/code-dirnodes
c/code-encoding
c/code-frontend
c/code-frontend-cli
c/code-frontend-ftp-sftp
c/code-frontend-magic-folder
c/code-frontend-web
c/code-mutable
c/code-network
c/code-nodeadmin
c/code-peerselection
c/code-storage
c/contrib
c/dev-infrastructure
c/docs
c/operational
c/packaging
c/unknown
c/website
kw:2pc
kw:410
kw:9p
kw:ActivePerl
kw:AttributeError
kw:DataUnavailable
kw:DeadReferenceError
kw:DoS
kw:FileZilla
kw:GetLastError
kw:IFinishableConsumer
kw:K
kw:LeastAuthority
kw:Makefile
kw:RIStorageServer
kw:StringIO
kw:UncoordinatedWriteError
kw:about
kw:access
kw:access-control
kw:accessibility
kw:accounting
kw:accounting-crawler
kw:add-only
kw:aes
kw:aesthetics
kw:alias
kw:aliases
kw:aliens
kw:allmydata
kw:amazon
kw:ambient
kw:annotations
kw:anonymity
kw:anonymous
kw:anti-censorship
kw:api_auth_token
kw:appearance
kw:appname
kw:apport
kw:archive
kw:archlinux
kw:argparse
kw:arm
kw:assertion
kw:attachment
kw:auth
kw:authentication
kw:automation
kw:avahi
kw:availability
kw:aws
kw:azure
kw:backend
kw:backoff
kw:backup
kw:backupdb
kw:backward-compatibility
kw:bandwidth
kw:basedir
kw:bayes
kw:bbfreeze
kw:beta
kw:binaries
kw:binutils
kw:bitcoin
kw:bitrot
kw:blacklist
kw:blocker
kw:blocks-cloud-deployment
kw:blocks-cloud-merge
kw:blocks-magic-folder-merge
kw:blocks-merge
kw:blocks-raic
kw:blocks-release
kw:blog
kw:bom
kw:bonjour
kw:branch
kw:branding
kw:breadcrumbs
kw:brians-opinion-needed
kw:browser
kw:bsd
kw:build
kw:build-helpers
kw:buildbot
kw:builders
kw:buildslave
kw:buildslaves
kw:cache
kw:cap
kw:capleak
kw:captcha
kw:cast
kw:centos
kw:cffi
kw:chacha
kw:charset
kw:check
kw:checker
kw:chroot
kw:ci
kw:clean
kw:cleanup
kw:cli
kw:cloud
kw:cloud-backend
kw:cmdline
kw:code
kw:code-checks
kw:coding-standards
kw:coding-tools
kw:coding_tools
kw:collection
kw:compatibility
kw:completion
kw:compression
kw:confidentiality
kw:config
kw:configuration
kw:configuration.txt
kw:conflict
kw:connection
kw:connectivity
kw:consistency
kw:content
kw:control
kw:control.furl
kw:convergence
kw:coordination
kw:copyright
kw:corruption
kw:cors
kw:cost
kw:coverage
kw:coveralls
kw:coveralls.io
kw:cpu-watcher
kw:cpyext
kw:crash
kw:crawler
kw:crawlers
kw:create-container
kw:cruft
kw:crypto
kw:cryptography
kw:cryptography-lib
kw:cryptopp
kw:csp
kw:curl
kw:cutoff-date
kw:cycle
kw:cygwin
kw:d3
kw:daemon
kw:darcs
kw:darcsver
kw:database
kw:dataloss
kw:db
kw:dead-code
kw:deb
kw:debian
kw:debug
kw:deep-check
kw:defaults
kw:deferred
kw:delete
kw:deletion
kw:denial-of-service
kw:dependency
kw:deployment
kw:deprecation
kw:desert-island
kw:desert-island-build
kw:design
kw:design-review-needed
kw:detection
kw:dev-infrastructure
kw:devpay
kw:directory
kw:directory-page
kw:dirnode
kw:dirnodes
kw:disconnect
kw:discovery
kw:disk
kw:disk-backend
kw:distribute
kw:distutils
kw:dns
kw:do_http
kw:doc-needed
kw:docker
kw:docs
kw:docs-needed
kw:dokan
kw:dos
kw:download
kw:downloader
kw:dragonfly
kw:drop-upload
kw:duplicity
kw:dusty
kw:earth-dragon
kw:easy
kw:ec2
kw:ecdsa
kw:ed25519
kw:egg-needed
kw:eggs
kw:eliot
kw:email
kw:empty
kw:encoding
kw:endpoint
kw:enterprise
kw:enum34
kw:environment
kw:erasure
kw:erasure-coding
kw:error
kw:escaping
kw:etag
kw:etch
kw:evangelism
kw:eventual
kw:example
kw:excess-authority
kw:exec
kw:exocet
kw:expiration
kw:extensibility
kw:extension
kw:failure
kw:fedora
kw:ffp
kw:fhs
kw:figleaf
kw:file
kw:file-descriptor
kw:filename
kw:filesystem
kw:fileutil
kw:fips
kw:firewall
kw:first
kw:floatingpoint
kw:flog
kw:foolscap
kw:forward-compatibility
kw:forward-secrecy
kw:forwarding
kw:free
kw:freebsd
kw:frontend
kw:fsevents
kw:ftp
kw:ftpd
kw:full
kw:furl
kw:fuse
kw:garbage
kw:garbage-collection
kw:gateway
kw:gatherer
kw:gc
kw:gcc
kw:gentoo
kw:get
kw:git
kw:git-annex
kw:github
kw:glacier
kw:globalcaps
kw:glossary
kw:google-cloud-storage
kw:google-drive-backend
kw:gossip
kw:governance
kw:grid
kw:grid-manager
kw:gridid
kw:gridsync
kw:grsec
kw:gsoc
kw:gvfs
kw:hackfest
kw:hacktahoe
kw:hang
kw:hardlink
kw:heartbleed
kw:heisenbug
kw:help
kw:helper
kw:hint
kw:hooks
kw:how
kw:how-to
kw:howto
kw:hp
kw:hp-cloud
kw:html
kw:http
kw:https
kw:i18n
kw:i2p
kw:i2p-collab
kw:illustration
kw:image
kw:immutable
kw:impressions
kw:incentives
kw:incident
kw:init
kw:inlineCallbacks
kw:inotify
kw:install
kw:installer
kw:integration
kw:integration-test
kw:integrity
kw:interactive
kw:interface
kw:interfaces
kw:interoperability
kw:interstellar-exploration
kw:introducer
kw:introduction
kw:iphone
kw:ipkg
kw:iputil
kw:ipv6
kw:irc
kw:jail
kw:javascript
kw:joke
kw:jquery
kw:json
kw:jsui
kw:junk
kw:key-value-store
kw:kfreebsd
kw:known-issue
kw:konqueror
kw:kpreid
kw:kvm
kw:l10n
kw:lae
kw:large
kw:latency
kw:leak
kw:leasedb
kw:leases
kw:libgmp
kw:license
kw:licenss
kw:linecount
kw:link
kw:linux
kw:lit
kw:localhost
kw:location
kw:locking
kw:logging
kw:logo
kw:loopback
kw:lucid
kw:mac
kw:macintosh
kw:magic-folder
kw:manhole
kw:manifest
kw:manual-test-needed
kw:map
kw:mapupdate
kw:max_space
kw:mdmf
kw:memcheck
kw:memory
kw:memory-leak
kw:mesh
kw:metadata
kw:meter
kw:migration
kw:mime
kw:mingw
kw:minimal
kw:misc
kw:miscapture
kw:mlp
kw:mock
kw:more-info-needed
kw:mountain-lion
kw:move
kw:multi-users
kw:multiple
kw:multiuser-gateway
kw:munin
kw:music
kw:mutability
kw:mutable
kw:mystery
kw:names
kw:naming
kw:nas
kw:navigation
kw:needs-review
kw:needs-spawn
kw:netbsd
kw:network
kw:nevow
kw:new-user
kw:newcaps
kw:news
kw:news-done
kw:news-needed
kw:newsletter
kw:newurls
kw:nfc
kw:nginx
kw:nixos
kw:no-clobber
kw:node
kw:node-url
kw:notification
kw:notifyOnDisconnect
kw:nsa310
kw:nsa320
kw:nsa325
kw:numpy
kw:objects
kw:old
kw:openbsd
kw:openitp-packaging
kw:openssl
kw:openstack
kw:opensuse
kw:operation-helpers
kw:operational
kw:operations
kw:ophandle
kw:ophandles
kw:ops
kw:optimization
kw:optional
kw:options
kw:organization
kw:os
kw:os.abort
kw:ostrom
kw:osx
kw:osxfuse
kw:otf-magic-folder-objective1
kw:otf-magic-folder-objective2
kw:otf-magic-folder-objective3
kw:otf-magic-folder-objective4
kw:otf-magic-folder-objective5
kw:otf-magic-folder-objective6
kw:p2p
kw:packaging
kw:partial
kw:password
kw:path
kw:paths
kw:pause
kw:peer-selection
kw:performance
kw:permalink
kw:permissions
kw:persistence
kw:phone
kw:pickle
kw:pip
kw:pipermail
kw:pkg_resources
kw:placement
kw:planning
kw:policy
kw:port
kw:portability
kw:portal
kw:posthook
kw:pratchett
kw:preformance
kw:preservation
kw:privacy
kw:process
kw:profile
kw:profiling
kw:progress
kw:proxy
kw:publish
kw:pyOpenSSL
kw:pyasn1
kw:pycparser
kw:pycrypto
kw:pycrypto-lib
kw:pycryptopp
kw:pyfilesystem
kw:pyflakes
kw:pylint
kw:pypi
kw:pypy
kw:pysqlite
kw:python
kw:python3
kw:pythonpath
kw:pyutil
kw:pywin32
kw:quickstart
kw:quiet
kw:quotas
kw:quoting
kw:raic
kw:rainhill
kw:random
kw:random-access
kw:range
kw:raspberry-pi
kw:reactor
kw:readonly
kw:rebalancing
kw:recovery
kw:recursive
kw:redhat
kw:redirect
kw:redressing
kw:refactor
kw:referer
kw:referrer
kw:regression
kw:rekey
kw:relay
kw:release
kw:release-blocker
kw:reliability
kw:relnotes
kw:remote
kw:removable
kw:removable-disk
kw:rename
kw:renew
kw:repair
kw:replace
kw:report
kw:repository
kw:research
kw:reserved_space
kw:response-needed
kw:response-time
kw:restore
kw:retrieve
kw:retry
kw:review
kw:review-needed
kw:reviewed
kw:revocation
kw:roadmap
kw:rollback
kw:rpm
kw:rsa
kw:rss
kw:rst
kw:rsync
kw:rusty
kw:s3
kw:s3-backend
kw:s3-frontend
kw:s4
kw:same-origin
kw:sandbox
kw:scalability
kw:scaling
kw:scheduling
kw:schema
kw:scheme
kw:scp
kw:scripts
kw:sdist
kw:sdmf
kw:security
kw:self-contained
kw:server
kw:servermap
kw:servers-of-happiness
kw:service
kw:setup
kw:setup.py
kw:setup_requires
kw:setuptools
kw:setuptools_darcs
kw:sftp
kw:shared
kw:shareset
kw:shell
kw:signals
kw:simultaneous
kw:six
kw:size
kw:slackware
kw:slashes
kw:smb
kw:sneakernet
kw:snowleopard
kw:socket
kw:solaris
kw:space
kw:space-efficiency
kw:spam
kw:spec
kw:speed
kw:sqlite
kw:ssh
kw:ssh-keygen
kw:sshfs
kw:ssl
kw:stability
kw:standards
kw:start
kw:startup
kw:static
kw:static-analysis
kw:statistics
kw:stats
kw:stats_gatherer
kw:status
kw:stdeb
kw:storage
kw:streaming
kw:strports
kw:style
kw:stylesheet
kw:subprocess
kw:sumo
kw:survey
kw:svg
kw:symlink
kw:synchronous
kw:tac
kw:tahoe-*
kw:tahoe-add-alias
kw:tahoe-admin
kw:tahoe-archive
kw:tahoe-backup
kw:tahoe-check
kw:tahoe-cp
kw:tahoe-create-alias
kw:tahoe-create-introducer
kw:tahoe-debug
kw:tahoe-deep-check
kw:tahoe-deepcheck
kw:tahoe-lafs-trac-stream
kw:tahoe-list-aliases
kw:tahoe-ls
kw:tahoe-magic-folder
kw:tahoe-manifest
kw:tahoe-mkdir
kw:tahoe-mount
kw:tahoe-mv
kw:tahoe-put
kw:tahoe-restart
kw:tahoe-rm
kw:tahoe-run
kw:tahoe-start
kw:tahoe-stats
kw:tahoe-unlink
kw:tahoe-webopen
kw:tahoe.css
kw:tahoe_files
kw:tahoewapi
kw:tarball
kw:tarballs
kw:tempfile
kw:templates
kw:terminology
kw:test
kw:test-and-set
kw:test-from-egg
kw:test-needed
kw:testgrid
kw:testing
kw:tests
kw:throttling
kw:ticket999-s3-backend
kw:tiddly
kw:time
kw:timeout
kw:timing
kw:to
kw:to-be-closed-on-2011-08-01
kw:tor
kw:tor-protocol
kw:torsocks
kw:tox
kw:trac
kw:transparency
kw:travis
kw:travis-ci
kw:trial
kw:trickle
kw:trivial
kw:truckee
kw:tub
kw:tub.location
kw:twine
kw:twistd
kw:twistd.log
kw:twisted
kw:twisted-14
kw:twisted-trial
kw:twitter
kw:twn
kw:txaws
kw:type
kw:typeerror
kw:ubuntu
kw:ucwe
kw:ueb
kw:ui
kw:unclean
kw:uncoordinated-writes
kw:undeletable
kw:unfinished-business
kw:unhandled-error
kw:unhappy
kw:unicode
kw:unit
kw:unix
kw:unlink
kw:update
kw:upgrade
kw:upload
kw:upload-helper
kw:uri
kw:url
kw:usability
kw:use-case
kw:utf-8
kw:util
kw:uwsgi
kw:ux
kw:validation
kw:variables
kw:vdrive
kw:verify
kw:verlib
kw:version
kw:versioning
kw:versions
kw:video
kw:virtualbox
kw:virtualenv
kw:vista
kw:visualization
kw:visualizer
kw:vm
kw:volunteergrid2
kw:volunteers
kw:vpn
kw:wapi
kw:warners-opinion-needed
kw:warning
kw:weapi
kw:web
kw:web.port
kw:webapi
kw:webdav
kw:webdrive
kw:webport
kw:websec
kw:website
kw:websocket
kw:welcome
kw:welcome-page
kw:welcomepage
kw:wiki
kw:win32
kw:win64
kw:windows
kw:windows-related
kw:winscp
kw:workaround
kw:world-domination
kw:wrapper
kw:write-enabler
kw:wui
kw:x86
kw:x86-64
kw:xhtml
kw:xml
kw:xss
kw:zbase32
kw:zetuptoolz
kw:zfec
kw:zookos-opinion-needed
kw:zope
kw:zope.interface
p/blocker
p/critical
p/major
p/minor
p/normal
p/supercritical
p/trivial
r/cannot reproduce
r/duplicate
r/fixed
r/invalid
r/somebody else's problem
r/was already fixed
r/wontfix
r/worksforme
t/defect
t/enhancement
t/task
v/0.2.0
v/0.3.0
v/0.4.0
v/0.5.0
v/0.5.1
v/0.6.0
v/0.6.1
v/0.7.0
v/0.8.0
v/0.9.0
v/1.0.0
v/1.1.0
v/1.10.0
v/1.10.1
v/1.10.2
v/1.10a2
v/1.11.0
v/1.12.0
v/1.12.1
v/1.13.0
v/1.14.0
v/1.15.0
v/1.15.1
v/1.2.0
v/1.3.0
v/1.4.1
v/1.5.0
v/1.6.0
v/1.6.1
v/1.7.0
v/1.7.1
v/1.7β
v/1.8.0
v/1.8.1
v/1.8.2
v/1.8.3
v/1.8β
v/1.9.0
v/1.9.0-s3branch
v/1.9.0a1
v/1.9.0a2
v/1.9.0b1
v/1.9.1
v/1.9.2
v/1.9.2a1
v/cloud-branch
v/unknown
No milestone
No project
No assignees
5 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: tahoe-lafs/trac#964
No description provided.