From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Tue, 24 Nov 2020 00:00:51 +0000 (-0800)
Subject: update docs
X-Git-Tag: 20201202~16
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=45512cfe43a89cedb7434be927ae294b5d840f8b;p=perltidy.git

update docs
---

diff --git a/docs/BugLog.html b/docs/BugLog.html
index 6268d1f0..507b17cf 100644
--- a/docs/BugLog.html
+++ b/docs/BugLog.html
@@ -21,6 +21,30 @@
 
 <dl>
 
+<dt id="fix-to-stop-at-1-iteration-when-using---indent-only"><b>fix to stop at 1 iteration when using --indent-only</b></dt>
+<dd>
+
+<p>Previously, for the combination --indent-only and -conv, two iterations would be done. Only one iteration is necessary in this case.</p>
+
+</dd>
+<dt id="fix-for-formatting-signed-numbers-with-spaces"><b>fix for formatting signed numbers with spaces</b></dt>
+<dd>
+
+<p>In developing an improved convergence test, an issue slowing convergence was found related to signed numbers as in the following line,</p>
+
+<pre><code>    @london = (deg2rad(-  0.5), deg2rad(90 - 51.3));</code></pre>
+
+<p>The leading &#39;-&#39; here is separated from the following number &#39;0.5&#39;. This is handled by tokenizing the minus as type &#39;m&#39; and the number as type &#39;n&#39;. The whitespace between them is removed in formatting, and so the space is gone in the output. But a little problem is that the default rule for placing spaces within the parens is based on the token count, after the first formatting the result is</p>
+
+<pre><code>    @london = ( deg2rad( -0.5 ), deg2rad( 90 - 51.3 ) );</code></pre>
+
+<p>The next time it is formatted, the &#39;-0.5&#39; counts as one token, resulting in</p>
+
+<pre><code>    @london = ( deg2rad(-0.5), deg2rad( 90 - 51.3 ) );</code></pre>
+
+<p>Notice that the space within the parens around the &#39;-0.5&#39; is gone. An update was made to fix this, so that the final state is reached in one step. This fix was made 23 Nov 2020.</p>
+
+</dd>
 <dt id="fix-to-prevent-conversion-of-a-block-comment-to-hanging-side-comment"><b>fix to prevent conversion of a block comment to hanging side comment</b></dt>
 <dd>
 
diff --git a/local-docs/BugLog.pod b/local-docs/BugLog.pod
index 114d9964..03181017 100644
--- a/local-docs/BugLog.pod
+++ b/local-docs/BugLog.pod
@@ -2,6 +2,11 @@
 
 =over 4
 
+=item B<fix to stop at 1 iteration when using --indent-only>
+
+Previously, for the combination --indent-only and -conv, two iterations
+would be done.  Only one iteration is necessary in this case.
+
 =item B<fix for formatting signed numbers with spaces>
 
 In developing an improved convergence test, an issue slowing convergence