update docs

diff --git a/CHANGES.md b/CHANGES.md
index 2da7e18e55c03218d798933e3527824462b47109..8caa3df8a3dd478ad795eebb00b8721d328540f8 100644 (file)
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -2,7 +2,11 @@
 
 ## 2020 10 01.03
 
-    - Fixed issue git #44, -vtc=n flag was ignored when -wn was set.
+    - This release is being made to make available a number of new formatting 
+      parameters. No significant bugs have been found since the previous release, 
+      but several minor issues have been found and fixed as listed below.
+
+    - Fixed issue git #45, -vtc=n flag was ignored when -wn was set.
 
     - implement request RT #133649, delete-old-newlines selectively. Two parameters, 
 
@@ -46,8 +50,6 @@
 
     - Fix issue git #41, typo in manual regarding -fsb.
 
-    - Some problems with parsing complex multi-line sub signatures have been fixed.
-
     - Fix issue git #40: when using the -bli option, a closing brace followed by 
       a semicolon was not being indented.  This applies to braces which require 
       semicolons, such as a 'do' block.
@@ -57,6 +59,29 @@
     - This version is about 15% faster than previous versions due to some optimizations
       made with the help of Devel::NYTProf.
 
+    - Line breaks are now automatically placed after 'use overload' to 
+      improve formatting when there are numerous overloaded operators.  For
+      example
+ 
+        use overload
+          '+' => sub {
+          ...
+
+    - A number of minor problems with parsing signatures and prototypes have
+      been corrected, particularly multi-line signatures. Some signatures 
+      had previously been parsed as if they were prototypes, which meant the 
+      normal spacing rules were not applied.  For example
+   
+      OLD:
+        sub echo ($message= 'Hello World!' ) {
+            ...;
+        }
+
+      NEW:
+        sub echo ( $message = 'Hello World!' ) {
+            ...;
+        }
+
     - Numerous minor issues that the average user would not encounter were found
       and fixed. They can be seen in the more complete list of updates at 
 

diff --git a/t/snippets/random_file_generator.pl b/t/snippets/random_file_generator.pl
index b7abcffbd9fe891ab548082f6f2c14b9ea4d0795..0776526f94ec0bb39a7a784ff87359a13f3b0884 100755 (executable)
--- a/t/snippets/random_file_generator.pl
+++ b/t/snippets/random_file_generator.pl
@@ -235,7 +235,7 @@ sub select_random_lines {
 sub reverse_random_lines { 
 
     # skip some fraction of the lines in a source file
-    # but keep lines in the original order
+    # and reverse the characters on a line
     my ($rsource, $frand) = @_;
 
     my %select;