diff --git a/Readme.rst b/Readme.rst
index 2f28dfd06..66ec5106c 100644
--- a/Readme.rst
+++ b/Readme.rst
@@ -2361,6 +2361,10 @@ directory.
 
   A graphical interface for creating items.
 
+* gui/dfstatus
+
+  Show a quick overview of critical stock quantities, including food, drinks, wood, and various bars.
+
 * gui/stockpiles
 
   Load and save stockpile settings from the 'q' menu.
@@ -2399,7 +2403,8 @@ Usage::
 
 autounsuspend
 =============
-Automatically unsuspend all jobs, on a recurring basis.  See ``unsuspend`` for one-off use.
+Automatically unsuspend construction jobs, on a recurring basis.
+See ``unsuspend`` for one-off use, or ``resume all``.
 
 ban-cooking
 ===========
@@ -2455,10 +2460,6 @@ Focus a body part ingame, and this script will display the cause of death of
 the creature.
 Also works when selecting units from the (``u``) unitlist viewscreen.
 
-dfstatus
-========
-Show a quick overview of critical stock quantities, including food, drinks, wood, and various bars.
-
 digfort
 =======
 A script to designate an area for digging according to a plan in csv format.
@@ -2643,7 +2644,7 @@ There are the following ways to invoke this command:
 
 make-monarch
 ============
-Make the selected unit King or Queen or your civilisation.
+Make the selected unit King or Queen of your civilisation.
 
 markdown
 ========
@@ -2835,7 +2836,8 @@ Undesignates building base materials for dumping.
 
 unsuspend
 =========
-Unsuspend all jobs, on a one-off basis.  See ``autounsuspend`` for regular use.
+Unsuspend construction jobs, on a one-off basis.  See ``autounsuspend`` for regular use.
+Equivalent to ``resume all``.
 
 view-item-info
 ==============
diff --git a/scripts/autounsuspend.rb b/scripts/autounsuspend.rb
index 94c6b1f26..9613288ba 100644
--- a/scripts/autounsuspend.rb
+++ b/scripts/autounsuspend.rb
@@ -1,4 +1,4 @@
-# un-suspend all jobs, on a recurring basis
+# un-suspend construction jobs, on a recurring basis
 
 class AutoUnsuspend
     attr_accessor :running
diff --git a/scripts/unsuspend.rb b/scripts/unsuspend.rb
index 0e1f52f35..bd0c3ad78 100644
--- a/scripts/unsuspend.rb
+++ b/scripts/unsuspend.rb
@@ -1,4 +1,5 @@
-# un-suspend all jobs, one time only
+# un-suspend construction jobs, one time only
+# same as "resume all"
 
 joblist = df.world.job_list.next
 count = 0