update docs

diff --git a/CHANGES.md b/CHANGES.md
index 857482997af6d29a13344091eb13d8d06784306b..b076d162f01442dfd61240beef89b73842202097 100644 (file)
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -12,7 +12,7 @@
 
     - Numerous issues have been found during automated testing and fixed. Many involve references to
       uninitialized variables when perltidy is given random text. A complete list is given in
-      the file 'BugLog.pod'.
+      the file [BugLog.pod](https://github.com/perltidy/perltidy/blob/master/local-docs/BugLog.pod).
 
 ## 2020 09 07
 

diff --git a/local-docs/BugLog.pod b/local-docs/BugLog.pod
index 46094a3e9c04462f575c904b0a6cd5231342f214..ccbe6d9f29d0711a4fd1ba1d969fa86a1d6c18ef 100644 (file)
--- a/local-docs/BugLog.pod
+++ b/local-docs/BugLog.pod
@@ -5,6 +5,13 @@ found with the help of automated random testing.
 
 =over
 
+=item B<If an =cut starts a POD section within code, give a warning>
+
+Previously only a complaint was given, which went into the log file and was not normally
+seen.  Perl silently accepts this but it can cause significant problems with pod utilities, so
+a clear warning is better.  This situation arose in testing on random files in combination with
+a -dp flag and it took some time to understand the results because of the lack of a warning.
+
 =item B<Switched from using an eval block to the ->can() function for sub finish_formatting>
 
 This is not a bug, but is cleaner coding and insures that error messages get reported.