add warning about inappropriate -x flag

diff --git a/bin/perltidy b/bin/perltidy
index 1164f1cedd55630c463c842edada50fd1cca3317..c8753c4a2e8b3d0c85d8cc24a4de014afc99fc71 100755 (executable)
--- a/bin/perltidy
+++ b/bin/perltidy
@@ -3612,6 +3612,11 @@ lines before the "hash-bang" line.  This option also invokes perl with a
 allow perltidy to parse interactive VMS scripts, but it should be used
 for any script which is normally invoked with C<perl -x>.
 
+Please note: do not use this flag unless you are sure your script needs it.
+Parsing errors can occur if it does not have a hash-bang.  For example, if the
+actual first hash-bang is in a here-doc, a parsing error will occur because the
+tokenization will begin in the middle of the here-doc.
+
 =item  Making a file unreadable
 
 The goal of perltidy is to improve the readability of files, but there