diff options
| author | Tim Graham <timograham@gmail.com> | 2012-11-23 07:00:08 -0500 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2012-11-23 07:02:29 -0500 |
| commit | c90156fc188200795a24c24b9ea97eef32356e55 (patch) | |
| tree | 7aa8e6019f620ac1e6287ca87c2c2012546ffac2 /docs/ref | |
| parent | a892cd3191cd2e0d98756764ed7be3ad59b95850 (diff) | |
[1.5.X] Fixed #19348 - Clarified the units of filesizeformat.
Thanks george_edison for the report and Claude Paroz for the patch.
Backport of 63e6cd1bb3 from master
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/templates/builtins.txt | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index d30eb21a41..656cbedecd 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -1439,6 +1439,14 @@ For example:: If ``value`` is 123456789, the output would be ``117.7 MB``. +.. admonition:: File sizes and SI units + + Strictly speaking, ``filesizeformat`` does not conform to the International + System of Units which recommends using KiB, MiB, GiB, etc. when byte sizes + are calculated in powers of 1024 (which is the case here). Instead, Django + uses traditional unit names (KB, MB, GB, etc.) corresponding to names that + are more commonly used. + .. templatefilter:: first first |