From a459ddd9136609aa5eceec0f5ce850944269a10e Mon Sep 17 00:00:00 2001
From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Sat, 12 Dec 2020 07:18:17 -0800
Subject: [PATCH] update docs

---
 local-docs/BugLog.pod | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/local-docs/BugLog.pod b/local-docs/BugLog.pod
index b5f63dda..f2e1a37d 100644
--- a/local-docs/BugLog.pod
+++ b/local-docs/BugLog.pod
@@ -2,6 +2,24 @@
 
 =over 4
 
+=item B<Do not align equals across changes in continuation indentation>
+
+A rule was added to prevent vertical alignment of lines with leading '=' across
+a change in continuation indentation. Sometimes aligning across a change in CI
+can come out okay, but sometimes it can be very poor. For example:
+
+    # BAD:
+    $!               = 2, die qq/$0: can't stat -${arg}'s "$file"./
+	unless $time = ( stat($file) )[$STAT_MTIME];
+
+    # FIXED:
+    $! = 2, die qq/$0: can't stat -${arg}'s "$file"./
+      unless $time = ( stat($file) )[$STAT_MTIME];
+
+The second line is a continuation of the first, and this update prevents this
+alignment.  The above 'BAD' formatting was in the previous developmental
+version of perltidy, not the previous release. This update added 12 Dec 2020.
+
 =item B<Improve vertical alignment in some two-line matches>
 
 When two lines would be perfectly aligned except for the line length limit,
-- 
2.39.5