From 76c0804bd5fbbfec56491792d64d30302638503e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antoine=20Beaupr=C3=A9?= <anarcat@koumbit.org>
Date: Wed, 21 Oct 2015 09:25:46 -0400
Subject: [PATCH] explicitely commit to the units standard, see #289

---
 docs/usage.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/usage.rst b/docs/usage.rst
index 731efc26f..30e6f0914 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -134,6 +134,19 @@ Network:
 In case you are interested in more details, please read the internals documentation.
 
 
+Units
+-----
+
+To display quantities, |project_name| takes care of respecting the
+usual conventions of scale. Disk sizes are displayed in `decimal
+<https://en.wikipedia.org/wiki/Decimal>`_, using powers of ten (so
+``kB`` means 1000 bytes). For memory usage, `binary prefixes
+<https://en.wikipedia.org/wiki/Binary_prefix>`_ are used, and are
+indicated using the `IEC binary prefixes
+<https://en.wikipedia.org/wiki/IEC_80000-13#Prefixes_for_binary_multiples>`_,
+using powers of two (so ``KiB`` means 1024 bytes).
+
+
 .. include:: usage/init.rst.inc
 
 Examples