diff --git a/default_settings.lua b/default_settings.lua
index 5073b7d..c211153 100644
--- a/default_settings.lua
+++ b/default_settings.lua
@@ -29,9 +29,10 @@ local settings = {
 	delete_item_on_clearobject = true,
 }
 
--- documentation for toggles controlling pressure logic features
--- do not edit this;
--- instead, copy the uncommented lines into pipeworks_settings.txt in your world directory.
+-- documentation for toggles controlling pressure logic features.
+-- do not edit this file directly;
+-- instead, create pipeworks_settings.txt in your world directory,
+-- and copy the uncommented lines from the block comment below into it.
 --[[
 -- enable pressure logic mode instead of "classic" mode.
 -- WARNING: this changes a few things, most noticeably how pumps work.
@@ -40,11 +41,15 @@ pipeworks.toggles.pressure_logic = true
 
 -- force-enable finite water handling mode.
 -- this changes the way that water node placement is handled;
--- volume will always be preserved, and water is assumed to move itself downwards.
--- nil (the default) means autodetect from installed finite liquid mods, true is force-on, false is force-off.
--- note that you should NOT normally explicitly set this to either true or false,
--- unless the mod you want this for is not covered by autodetect-finite-water.lua.
--- please file an issue if you need to use this for a finite water mod exists not covered there.
+-- volume will always be preserved,
+-- and water is assumed to move itself downwards.
+-- nil (the default) means autodetect from installed finite liquid mods,
+-- true is force-on, false is force-off.
+-- note that you should NOT normally explicitly set this to true/false,
+-- unless the mod you want this for is not covered by auto-detection
+-- (please see autodetect-finite-water.lua).
+-- please file an issue if you have a finite water mod not covered there,
+-- and feel it necessary to explicitly set this toggle
 pipeworks.toggles.finite_water = nil
 ]]