Skip to content

gh-152584: Reorganize the curses documentation into topic subsections#152583

Merged
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:curses-docs-reorg
Jun 29, 2026
Merged

gh-152584: Reorganize the curses documentation into topic subsections#152583
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:curses-docs-reorg

Conversation

@serhiy-storchaka

@serhiy-storchaka serhiy-storchaka commented Jun 29, 2026

Copy link
Copy Markdown
Member

The curses module reference presents its API as three large flat lists: 106 module-level functions, 103 window methods, and 181 constants. The flat ordering makes related calls hard to find — for example the color functions are scattered alphabetically among unrelated ones — and the key-constant table even carried an inline .. XXX this table is far too large! note.

This groups the functions, window methods and constants into topic subsections, following the categories used by the ncurses manual pages (initialization, input/output options, attributes, color, terminfo, mouse, and so on). Entries are only moved, not reworded; cross-references are unaffected since they resolve by name.

This is a documentation-only change, so it should skip the news entry.

Group the module-level functions, window methods and constants by topic
instead of presenting them as flat alphabetical lists, following the
categories used by the ncurses manual pages.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Jun 29, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 29, 2026
@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33352989 | 📁 Comparing 0c1556c against main (8ec36f1)

  🔍 Preview build  

1 file changed
± library/curses.html

@serhiy-storchaka serhiy-storchaka changed the title Reorganize the curses documentation into topic subsections gh-152584: Reorganize the curses documentation into topic subsections Jun 29, 2026
@serhiy-storchaka serhiy-storchaka merged commit bc08413 into python:main Jun 29, 2026
36 checks passed
@serhiy-storchaka serhiy-storchaka deleted the curses-docs-reorg branch June 29, 2026 13:15
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 29, 2026
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 skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant