FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

gh-143774 - Improve IDLE Format Paragraph doc by terryjreedy · Pull Request #143775 · python/cpython · GitHub

Repository navigation

gh-143774 - Improve IDLE Format Paragraph doc - #143775

Merged
terryjreedy merged 5 commits into
python:mainfrom
terryjreedy:reformat
Jan 20, 2026
Merged

terryjreedy merged 5 commits into
python:mainfrom
terryjreedy:reformat

Conversation

terryjreedy commented Jan 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

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 self-assigned this Jan 13, 2026
terryjreedy added the docs Documentation in the Doc dir label Jan 13, 2026
github-project-automation Bot moved this to Todo in Docs PRs Jan 13, 2026
terryjreedy changed the title Reformat gh-143774 - Improve IDLE Format Paragraph doc Jan 13, 2026

Copy link
Copy Markdown
Member

CC @adorilson

Copy link
Copy Markdown
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.".

Copy link
Copy Markdown
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 added needs backport to 3.13 only security fixes needs backport to 3.14 bugs and security fixes labels Jan 20, 2026
terryjreedy merged commit fa3abf5 into python:main Jan 20, 2026
51 checks passed
github-project-automation Bot moved this from Todo to Done in Docs PRs Jan 20, 2026

Copy link
Copy Markdown

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 fa3abf5)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
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 <tjreedy@udel.edu>
terryjreedy deleted the reformat branch January 20, 2026 09:07

bedevere-app Bot commented Jan 20, 2026

Copy link
Copy Markdown

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

bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jan 20, 2026

bedevere-app Bot commented Jan 20, 2026

Copy link
Copy Markdown

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

bedevere-app Bot removed the needs backport to 3.13 only 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 <tjreedy@udel.edu>
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 <tjreedy@udel.edu>
thunder-coding pushed a commit to thunder-coding/cpython that referenced this pull request Feb 15, 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.)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
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


Back | FazBrowse Home | New Git URL