Skip to content

gh-144067: Document terminal leak when initscr() follows setupterm() #152624

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
serhiy-storchaka merged 1 commit into from
Jul 2, 2026
Merged

gh-144067: Document terminal leak when initscr() follows setupterm() #152624

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions Doc/library/curses.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,8 @@ Initialization and termination
Initialize the library. Return a :ref:`window <curses-window-objects>` object
which represents the whole screen.

See :func:`setupterm` for a caveat about calling it before this function.

.. note::

If there is an error opening the terminal, the underlying curses library may
Expand Down Expand Up @@ -106,6 +108,8 @@ Initialization and termination
The new screen becomes the current one.
Use :func:`set_term` to switch between screens.

See :func:`setupterm` for a caveat about calling it before this function.

.. versionadded:: next

.. function:: new_prescr()
Expand Down Expand Up @@ -957,6 +961,13 @@ Terminfo database
terminfo database entry could not be read. If the terminal has already
been initialized, this function has no effect.

.. note::

Calling :func:`initscr` or :func:`newterm` after :func:`setupterm`
leaks the terminal that :func:`setupterm` allocated:
the curses library keeps only a single current terminal
and does not free the previously allocated one.

.. function:: tigetflag(capname)

Return the value of the Boolean capability corresponding to the terminfo
Expand Down
Loading