From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Fri, 15 Apr 2022 21:25:27 +0000 (-0700)
Subject: update docs
X-Git-Tag: 20220217.03~1
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=70617c5d5cc65f994d05987cedbe955784f51ebc;p=perltidy.git

update docs
---

diff --git a/CHANGES.md b/CHANGES.md
index da1981a2..c40b7027 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -2,6 +2,28 @@
 
 ## 2022 02 17.02
 
+    - The flag --encode-output-strings, or -eos, is now set on by default, as
+      noted in the discussion of issue git #92.  This has no effect on the use
+      of the 'perltidy' binary but could change the behavior of programs which
+      use the Perl::Tidy module on files encoded in UTF-8.  If any problems are
+      noticed, an emergency fix can be made by reverting to the old default with
+      the flag -neos.  For complete details see:
+
+           https://github.com/perltidy/perltidy/blob/master/docs/eos_flag.md
+
+    - Add vertical alignment for qw quotes in 'use' statements (see issue #git 93).
+      This is on by default but can be turned off with -vxl='q':
+
+        # old default or -vxl='q'
+        use Getopt::Long qw(GetOptions);
+        use Fcntl qw(O_RDONLY O_WRONLY O_EXCL O_CREAT);
+        use Symbol qw(gensym);
+
+        # new default
+        use Getopt::Long qw(GetOptions);
+        use Fcntl        qw(O_RDONLY O_WRONLY O_EXCL O_CREAT);
+        use Symbol       qw(gensym);
+
     - Fixed and reactivated two failing tests (were reading local .perltidyrc file)
 
 ## 2022 02 17
diff --git a/bin/perltidy b/bin/perltidy
index 0a63ff63..cf657093 100755
--- a/bin/perltidy
+++ b/bin/perltidy
@@ -4349,10 +4349,10 @@ parameters.  Most of the vertical alignments in typical programs occur at one
 of the tokens ',', '=', and '=>', but many other alignments are possible and are given in the following list:
 
   = **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=
-  { ( ? : , ; => && || ~~ !~~ =~ !~ // <=> ->
+  { ( ? : , ; => && || ~~ !~~ =~ !~ // <=> -> q
   if unless and or err for foreach while until
 
-These alignments are all enabled by default, but they can be selectively disabled by including one or more of these tokens in the space-separated list B<valign-exclusion-list=s>.
+The 'q' in this list refers to a qw quote. These alignments are all enabled by default, but they can be selectively disabled by including one or more of these tokens in the space-separated list B<valign-exclusion-list=s>.
 For example, the following would prevent alignment at B<=> and B<if>:
 
   --valign-exclusion-list='= if'