diff --git a/man/ostree.repo-config.xml b/man/ostree.repo-config.xml
index bb406a2e..dc126d65 100644
--- a/man/ostree.repo-config.xml
+++ b/man/ostree.repo-config.xml
@@ -129,24 +129,36 @@ Boston, MA 02111-1307, USA.
min-free-space-percent
- Integer percentage value (0-99) that specifies a minimum
- percentage of total space (in blocks) in the underlying filesystem to
- keep free. The default value is 3. This default value is enforced when none
- of min-free-space-* options are set.
- In case this option is co-existing with min-free-space-size (see below),
- and min-free-space-size is set to a non-zero value, min-free-space-percent
- would be ignored and min-free-space-size check would be enforced instead.
-
+
+
+ Integer percentage value (0-99) that specifies a minimum percentage
+ of total space (in blocks) in the underlying filesystem to keep
+ free. The default value is 3, which is enforced when neither this
+ option nor min-free-space-size are set.
+
+
+ If min-free-space-size is set to a non-zero
+ value, min-free-space-percent is ignored.
+
+
min-free-space-size
- Value (in MB, GB or TB) that specifies a minimum space in the
- underlying filesystem to keep free. Examples of acceptable values: 500MB, 1GB
- etc.
- In case this option is co-existing with min-free-space-percent (see above),
- and set to a non-zero value, this option takes priority.
-
+
+
+ Value (in power-of-2 MB, GB or TB) that specifies a minimum space
+ in the underlying filesystem to keep free. Examples of acceptable
+ values: 500MB (524 288 000 bytes),
+ 1GB (1 073 741 824 bytes),
+ 1TB (1 099 511 627 776 bytes).
+
+
+ If this option is set to a non-zero value, and
+ min-free-space-percent is also set, this option
+ takes priority.
+
+