summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2012-11-23 07:00:08 -0500
committerTim Graham <timograham@gmail.com>2012-11-23 07:00:08 -0500
commit63e6cd1bb3edccb4db1eb6a79153fa31d2114cd4 (patch)
treed599083ff54391bf934f73082b30c36c377e4c00 /docs
parent2875b5dcab23c027d019656b08da8b911bc60711 (diff)
Fixed #19348 - Clarified the units of filesizeformat.
Thanks george_edison for the report and Claude Paroz for the patch.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/templates/builtins.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 6e5e18543c..ba43e2eb15 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1456,6 +1456,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