From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Tue, 30 Jul 2024 01:35:29 +0000 (-0700)
Subject: update docs regarding git #156
X-Git-Tag: 20240511.08~8
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=71badf0f8efb353ac6e34a033fa2aa474c9a38ad;p=perltidy.git

update docs regarding git #156
---

diff --git a/bin/perltidy b/bin/perltidy
index 4147b76a..6c5c776e 100755
--- a/bin/perltidy
+++ b/bin/perltidy
@@ -3938,6 +3938,14 @@ The decision regarding whether or not a list is multi-line or bare is
 made based on the B<input> stream.  In some cases it may take an iteration
 or two to reach a final state.
 
+It can sometimes be preferable to base decisions on trailing commas
+on the final line breaks rather than the initial line breaks.
+This can be accomplished by telling perltidy to perform multiple internal
+iterations, for example with the B<--converge> parameter. In this case
+any comma addition or deletion operations are postponed until the
+start of the second iteration, after changes in line breaks have been made.
+For a discussion see L<https://github.com/perltidy/perltidy/issues/156>.
+
 =item *
 
 When using these parameters for the first time it is a good idea to practice