From: Steve Hancock <perltidy@users.sourceforge.net>
Date: Wed, 4 Dec 2024 15:15:52 +0000 (-0800)
Subject: add -mutt documentation
X-Git-Tag: 20240903.08~18
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a703433bb91e2f5553c51629833b81c5b9d2f512;p=perltidy.git

add -mutt documentation
---

diff --git a/CHANGES.md b/CHANGES.md
index df714faa..5ff04f49 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -2,6 +2,25 @@
 
 ## 2024 09 03.07
 
+    - Added parameter --multiple-token-tightness=s, or -mutt=s.
+    The default value --paren-tightness=1 adds space within the parens
+    if, and only if, the container holds multiple tokens.  Some perltidy
+    tokens may be rather long, and it can be preferable to also space some of
+    them as if they were multple tokens.  This can be done with this paramter,
+    and it applies to parens as well as square brackets and curly braces.
+    For example, the default below has no space within the square brackets:
+
+        # perltidy
+        my $rlist = [qw( alpha beta gamma )];
+
+    Spaces can be obtained with:
+
+        # perltidy -mutt='q*'
+        my $rlist = [ qw( alpha beta gamma ) ];
+
+    The parameter -mutt='q*' means treat qw and similar quote operators as
+    multiple tokens.  The manual has details; git #120 has another example.
+
     - Added parameter --indent-leading-semicolon, -ils; see git #171. When
     this is negated, a line with a leading semicolon does not get the extra
     leading continuation indentation spaces (defined with -ci=n).