diff --git a/docs/configuration_file_basics.xml b/docs/configuration_file_basics.xml
index 1f10ccf18..96eaaafb4 100644
--- a/docs/configuration_file_basics.xml
+++ b/docs/configuration_file_basics.xml
@@ -498,7 +498,10 @@ use Shorewall::Config qw/shorewall/;
END [ PERL ] [;]
-
+ Note: The '[' and ']' above are
+ meta-characters which indicate that what they enclose is optional and may
+ be omitted. So you may follow PERL with a semicolon ( ':') or you may omit
+ the semicolon.