update docs

diff --git a/bin/perltidy b/bin/perltidy
index 0622a563bee139235e9cb0b6c271fab46b191d2a..0822f664e8de7473fb135aa9272c11cace540132 100755 (executable)
--- a/bin/perltidy
+++ b/bin/perltidy
@@ -703,8 +703,10 @@ control.  For all practical purposes one either does or does not want to be
 sure that the output is converged, and there is no penalty to using a large
 iteration limit since perltidy will check for convergence and stop iterating as
 soon as possible.  The default is B<-nconv> (no convergence check).  Using
-B<-conv> will approximately double run time since normally one extra iteration
-is required to verify convergence.
+B<-conv> will approximately double run time since typically one extra iteration
+is required to verify convergence.  No extra iterations are required if no new
+line breaks are made, and two extra iterations are occasionally needed when
+reformatting complex code structures, such as deeply nested ternary statements.
 
 =back
 

diff --git a/local-docs/BugLog.pod b/local-docs/BugLog.pod
index 0318101771994186ada6ddd46742eca2179c55b4..3d28fcf2c63fa16fb76d69a9ecf4b4530d49789a 100644 (file)
--- a/local-docs/BugLog.pod
+++ b/local-docs/BugLog.pod
@@ -2,6 +2,12 @@
 
 =over 4
 
+=item B<do not automatically delete closing side comments with --indent-only>
+
+For the parameter combination --indent-only and --closing-side-comments, old
+closing side comments were getting deleted but new closing side comments were
+not made.  A fix was made to prevent this deletion.  This fix was made 27 Nov 2020.
+
 =item B<fix to stop at 1 iteration when using --indent-only>
 
 Previously, for the combination --indent-only and -conv, two iterations