Document comment behavior (#1052).

skel/etc/zope.conf.in

@@ -5,7 +5,9 @@
 # This is the Zope configuration file.  The Zope configuration file
 # shows what the default configuration directives are, and show
 # examples for each directive.  To declare a directive, make sure that
-# you add it to a line that does not begin with '#'.
+# you add it to a line that does not begin with '#'.  Note that comments 
+# are only allowed at the beginning of a line: you may not add comments
+# after directive text on the same line.
 
 # ZConfig "defines" used for later textual substitution