diff --git a/owlps-positioner/cfg/owlps-positioner.conf b/owlps-positioner/cfg/owlps-positioner.conf
index 43cd207..f82d127 100644
--- a/owlps-positioner/cfg/owlps-positioner.conf
+++ b/owlps-positioner/cfg/owlps-positioner.conf
@@ -2,6 +2,9 @@
 
 # [Miscellaneous options]
 
+# This option controls whether or not the output text files are flushed
+# (written to the storage support) after each line.
+# The default is to flush.
 #flush-output-files = true
 
 # "Replay" mode. With this option enabled, the current time is the
@@ -148,7 +151,8 @@ csv-file = /tmp/owlps-positioner.log
 #generated-meshing-grain-x = 0.5
 #generated-meshing-grain-y = 0.5
 # The Z option is currently a floor number instead of a vertical
-# coordinate in meters.
+# coordinate in meters. You should leave it to 1, except if you are
+# deploying across non-contiguous floors, which is unlikely.
 #generated-meshing-grain-z = 1
 
 # This option allows the calibration requests sent during the