From 71badf0f8efb353ac6e34a033fa2aa474c9a38ad Mon Sep 17 00:00:00 2001 From: Steve Hancock Date: Mon, 29 Jul 2024 18:35:29 -0700 Subject: [PATCH] update docs regarding git #156 --- bin/perltidy | 8 ++++++++ 1 file changed, 8 insertions(+) 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 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. + =item * When using these parameters for the first time it is a good idea to practice -- 2.39.5