Skip to content

Conversation

@terryjreedy
Copy link
Member

@terryjreedy terryjreedy commented Jan 13, 2026

Add a reminder to not rewrap code line to the Menu => Format => Reformat Paragraph entry.
In Editing and Nagivagion, add a new 'Format block' subsection that defines 'paragraph'
to better match what is dependably handled as more or less expected.
In particular, specify equal indents and that the resulting indent equals original indent.
Also mention that selections are expanded to complete lines and how to modify max length.

(Also fix a couple case errors in cross references.)


📚 Documentation preview 📚: https://cpython-previews--143775.org.readthedocs.build/

Define 'paragraph' better and mention indent preservation,
selection expansion, and length setting.
@terryjreedy terryjreedy self-assigned this Jan 13, 2026
@terryjreedy terryjreedy added the docs Documentation in the Doc dir label Jan 13, 2026
@github-project-automation github-project-automation bot moved this to Todo in Docs PRs Jan 13, 2026
@terryjreedy terryjreedy changed the title Reformat gh-143774 - Improve IDLE Format Paragraph doc Jan 13, 2026
@StanFromIreland
Copy link
Member

CC @adorilson

@adorilson
Copy link
Contributor

CC @adorilson

Thank you for the CC.

I think it resolves the problem. On the other hand, it seems too long.
IHMO, the most important sentence is "Avoid rewrapping code lines.".

@terryjreedy
Copy link
Member Author

I was more interested in defining the scope of the function but agree too long. I moved the new explanation to a new subsection with other explanatory notes.

@terryjreedy terryjreedy added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Jan 20, 2026
@terryjreedy terryjreedy merged commit fa3abf5 into python:main Jan 20, 2026
51 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Docs PRs Jan 20, 2026
@miss-islington-app
Copy link

Thanks @terryjreedy for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jan 20, 2026
Add a reminder to not rewrap code line to the Menu => Format => Reformat Paragraph entry.
In Editing and Nagivagion, add a new 'Format block' subsection that defines 'paragraph'
to better match what is dependably handled as more or less expected.
In particular, specify equal indents and that the resulting indent equals original indent.
Also mention that selections are expanded to complete lines and how to modify max length.

(Also fix a couple case errors in cross references.)
(cherry picked from commit fa3abf5a51d42b2d62e1bc89e9465b398a567e94)

Co-authored-by: Terry Jan Reedy <[email protected]>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jan 20, 2026
Add a reminder to not rewrap code line to the Menu => Format => Reformat Paragraph entry.
In Editing and Nagivagion, add a new 'Format block' subsection that defines 'paragraph'
to better match what is dependably handled as more or less expected.
In particular, specify equal indents and that the resulting indent equals original indent.
Also mention that selections are expanded to complete lines and how to modify max length.

(Also fix a couple case errors in cross references.)
(cherry picked from commit fa3abf5)

Co-authored-by: Terry Jan Reedy <[email protected]>
@terryjreedy terryjreedy deleted the reformat branch January 20, 2026 09:07
@bedevere-app
Copy link

bedevere-app bot commented Jan 20, 2026

GH-144062 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.14 bugs and security fixes label Jan 20, 2026
@bedevere-app
Copy link

bedevere-app bot commented Jan 20, 2026

GH-144063 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label Jan 20, 2026
terryjreedy added a commit that referenced this pull request Jan 20, 2026
…4063)

gh-143774 - Improve IDLE Format Paragraph doc (GH-143775)

Add a reminder to not rewrap code line to the Menu => Format => Reformat Paragraph entry.
In Editing and Nagivagion, add a new 'Format block' subsection that defines 'paragraph'
to better match what is dependably handled as more or less expected.
In particular, specify equal indents and that the resulting indent equals original indent.
Also mention that selections are expanded to complete lines and how to modify max length.

(Also fix a couple case errors in cross references.)
(cherry picked from commit fa3abf5)

Co-authored-by: Terry Jan Reedy <[email protected]>
terryjreedy added a commit that referenced this pull request Jan 20, 2026
…4062)

gh-143774 - Improve IDLE Format Paragraph doc (GH-143775)

Add a reminder to not rewrap code line to the Menu => Format => Reformat Paragraph entry.
In Editing and Nagivagion, add a new 'Format block' subsection that defines 'paragraph'
to better match what is dependably handled as more or less expected.
In particular, specify equal indents and that the resulting indent equals original indent.
Also mention that selections are expanded to complete lines and how to modify max length.

(Also fix a couple case errors in cross references.)
(cherry picked from commit fa3abf5)

Co-authored-by: Terry Jan Reedy <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants