Skip to content

Commit a9bfbf8

Browse files
committed
gh-143774 - Improve IDLE Format Paragraph doc
Define 'paragraph' better and mention indent preservation, selection expansion, and length setting.
1 parent a6bc60d commit a9bfbf8

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed

Doc/library/idle.rst

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -178,9 +178,14 @@ Format menu (Editor window only)
178178
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
179179

180180
Format Paragraph
181-
Reformat the current blank-line-delimited paragraph in comment block or
182-
multiline string or selected line in a string. All lines in the
183-
paragraph will be formatted to less than N columns, where N defaults to 72.
181+
Rewrap the current 'paragraph'. A paragraph is a contiguous block of
182+
equally indented non-blank comments containing the text cursor, a
183+
similar block of non-comment lines (expected to be within a multiline
184+
string), or a selection of a subset of either. (Partial lines in a
185+
selection expand to complete lines.) The resulting lines have the
186+
same indent as before but a max length of N columns (characters).
187+
Change the default N of 72 on the Window tab of IDLE Settings.
188+
Avoid rewrapping code lines.
184189

185190
Indent Region
186191
Shift selected lines right by the indent width (default 4 spaces).

0 commit comments

Comments
 (0)