From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Sat, 12 Dec 2020 15:18:17 +0000 (-0800)
Subject: update docs
X-Git-Tag: 20210111~42
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a459ddd9136609aa5eceec0f5ce850944269a10e;p=perltidy.git

update docs
---

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,