update docs

diff --git a/CHANGES.md b/CHANGES.md
index da1981a23d8384e025098049accfbcfd9570f882..c40b7027247c450ade6f2539fd3dce6e34073da4 100644 (file)
--- 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 0a63ff63a1bb16d811d67e866077a0156114e4b2..cf6570932d98a013846f3cd78d3bfc275d323efa 100755 (executable)
--- 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'