diff --git a/doc/postmodern.html b/doc/postmodern.html
index 18a282d..1eeae5b 100644
--- a/doc/postmodern.html
+++ b/doc/postmodern.html
@@ -3706,6 +3706,12 @@ <h3 id="function-execute-file">function execute-file (filename &amp;optional (pr
 print the count of the query and the query to the REPL.
 </p>
 
+<p>
+The default setting is to remove sql comments from the file before executing
+the sql code. If that causes problems, the remove-comments parameter can be
+set to nil.
+</p>
+
 <p>
 IMPORTANT NOTE: This utility function assumes that the file containing the sql
 queries can be trusted and bypasses the normal postmodern parameterization of
@@ -3916,7 +3922,10 @@ <h3 id="function-parse-queries">function parse-queries (file-content)</h3>
 <h3 id="function-read-queries">function read-queries (filename)</h3>
 <div class="outline-text-3" id="text-function-read-queries">
 <p>
-Read SQL queries in a given file and split them, returns a list.
+Read SQL queries in a given file and split them, returns a list. Track included
+files so there is no accidental infinite loop. The default setting is to remove
+sql comments from the file before executing the sql code. If that causes problems,
+the remove-comments parameter can be set to nil.
 </p>
 </div>
 </div>
diff --git a/doc/postmodern.org b/doc/postmodern.org
index 21ae956..7f8207f 100644
--- a/doc/postmodern.org
+++ b/doc/postmodern.org
@@ -2196,6 +2196,10 @@ the test file test-execute-file-broken-transaction.sql as an example.
 For debugging purposes, if the optional print parameter is set to t, format will
 print the count of the query and the query to the REPL.
 
+The default setting is to remove sql comments from the file before executing
+the sql code. If that causes problems, the remove-comments parameter can be
+set to nil.
+
 IMPORTANT NOTE: This utility function assumes that the file containing the sql
 queries can be trusted and bypasses the normal postmodern parameterization of
 queries.
@@ -2345,7 +2349,10 @@ Read SQL queries in given string and split them, returns a list.
    :CUSTOM_ID: function-read-queries
    :END:
 
-Read SQL queries in a given file and split them, returns a list.
+Read SQL queries in a given file and split them, returns a list. Track included
+files so there is no accidental infinite loop. The default setting is to remove
+sql comments from the file before executing the sql code. If that causes problems,
+the remove-comments parameter can be set to nil.
 ** function sql-escape-string (string)
    :PROPERTIES:
    :CUSTOM_ID: function-sql-escape-string
diff --git a/postmodern/execute-file.lisp b/postmodern/execute-file.lisp
index 4931119..91544a4 100644
--- a/postmodern/execute-file.lisp
+++ b/postmodern/execute-file.lisp
@@ -409,7 +409,7 @@ include commands \ir or \include_relative. Returns nil otherwise."
 (defun read-sql-file (filename &key (included-files nil)
                                  (output-stream (make-string-output-stream))
                                  (remove-comments t))
-  "Read a given file and strip the comments. Read lines from the redacted result
+  "Read a given file and (default) remove the comments. Read lines from the redacted result
 and return them in a stream. Recursively apply \i include instructions."
   (if (uiop:file-exists-p filename)
       (with-input-from-string
@@ -451,7 +451,9 @@ and return them in a stream. Recursively apply \i include instructions."
 
 (defun read-queries (filename &key (remove-comments t))
   "Read SQL queries in given file and split them, returns a list. Track included
-files so there is no accidental infinite loop."
+files so there is no accidental infinite loop. The default setting is to remove
+sql comments from the file before executing the sql code. If that causes problems,
+the remove-comments parameter can be set to nil."
   (parse-queries
    (get-output-stream-string
     (read-sql-file filename :remove-comments remove-comments))))
@@ -488,6 +490,10 @@ test file test-execute-file-broken-transaction.sql as an example.
 For debugging purposes, if the optional print parameter is set to t, format
 will print the count of the query and the query to the REPL.
 
+The default setting is to remove sql comments from the file before executing
+the sql code. If that causes problems, the remove-comments parameter can be
+set to nil.
+
 IMPORTANT NOTE: This utility function assumes that the file containing the
 sql queries can be trusted and bypasses the normal postmodern parameterization
 of queries."