diff --git a/docs/Actions.xml b/docs/Actions.xml
index 7a8796c80..f2de12748 100644
--- a/docs/Actions.xml
+++ b/docs/Actions.xml
@@ -554,9 +554,14 @@ add_rule $chainref, '-j ACCEPT';
 
     <para><filename>/etc/shorewall/actions</filename>:</para>
 
-    <para><programlisting>     LogAndAccept</programlisting><phrase><filename>/etc/shorewall/action.LogAndAccept</filename></phrase><programlisting>     LOG:info
+    <para><programlisting>     #ACTION             COMMENT (place '# ' below the 'C' in comment followed by
+     #                   v        a comment describing the action)
+     LogAndAccept        # LOG and ACCEPT a connection</programlisting><phrase><filename>/etc/shorewall/action.LogAndAccept</filename></phrase><programlisting>     LOG:info
      ACCEPT</programlisting></para>
 
+    <para>Placing a comment on the line causes the comment to appear in the
+    output of the <command>shorewall show actions</command> command.</para>
+
     <para>To use your action, in <filename>/etc/shorewall/rules</filename> you
     might do something like:</para>