diff --git a/README.rst b/README.rst
index eb11da991c..0efe194d79 100644
--- a/README.rst
+++ b/README.rst
@@ -808,8 +808,8 @@ This will turn all stone fortifications into floors, preserving the material.
 Or this:
 ::  
 
-        filter material FLOOR
-        filter shape MINERAL
+        filter shape FLOOR
+        filter material MINERAL
         paint shape WALL
 
 Turning mineral vein floors back into walls.
@@ -821,8 +821,9 @@ Or this:
 ::  
 
         paint hidden 1
+        paint hidden 0
 
-This will hide previously revealed tiles.
+This will hide previously revealed tiles (or show hidden with the 0 option).
 
 Any paint or filter option can be disabled entirely by using the ANY keyword:
 
diff --git a/Readme.html b/Readme.html
index bfbab385a1..49ddb19845 100644
--- a/Readme.html
+++ b/Readme.html
@@ -1557,8 +1557,8 @@ <h2><a class="toc-backref" href="#id132">tiletypes</a></h2>
 <p>This will turn all stone fortifications into floors, preserving the material.</p>
 <p>Or this:</p>
 <pre class="literal-block">
-filter material FLOOR
-filter shape MINERAL
+filter shape FLOOR
+filter material MINERAL
 paint shape WALL
 </pre>
 <p>Turning mineral vein floors back into walls.</p>
@@ -1566,8 +1566,9 @@ <h2><a class="toc-backref" href="#id132">tiletypes</a></h2>
 <p>Or this:</p>
 <pre class="literal-block">
 paint hidden 1
+paint hidden 0
 </pre>
-<p>This will hide previously revealed tiles.</p>
+<p>This will hide previously revealed tiles (or show hidden with the 0 option).</p>
 <p>Any paint or filter option can be disabled entirely by using the ANY keyword:</p>
 <pre class="literal-block">
 paint hidden ANY