[Python-checkins] Document a workaround for a curses bug (GH-13209)
Lisa Roach
webhook-mailer at python.org
Fri May 17 18:54:06 EDT 2019
https://github.com/python/cpython/commit/e7b1136ec3b40d174d71f2195cceaadf4fe9539c
commit: e7b1136ec3b40d174d71f2195cceaadf4fe9539c
branch: master
author: Toshio Kuratomi <a.badger at gmail.com>
committer: Lisa Roach <lisaroach14 at gmail.com>
date: 2019-05-17T15:54:02-07:00
summary:
Document a workaround for a curses bug (GH-13209)
files:
A Misc/NEWS.d/next/Documentation/2019-05-08-13-17-44.bpo-35924.lqbNpW.rst
M Doc/library/curses.rst
diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
index 2a4d9ce8a35a..7d1e7538a292 100644
--- a/Doc/library/curses.rst
+++ b/Doc/library/curses.rst
@@ -708,9 +708,16 @@ the following methods and attributes:
.. note::
- Writing outside the window, subwindow, or pad raises :exc:`curses.error`.
- Attempting to write to the lower right corner of a window, subwindow,
- or pad will cause an exception to be raised after the string is printed.
+ * Writing outside the window, subwindow, or pad raises :exc:`curses.error`.
+ Attempting to write to the lower right corner of a window, subwindow,
+ or pad will cause an exception to be raised after the string is printed.
+
+ * A `bug in ncurses <https://bugs.python.org/issue35924>`_, the backend
+ for this Python module, can cause SegFaults when resizing windows. This
+ is fixed in ncurses-6.1-20190511. If you are stuck with an earlier
+ ncurses, you can avoid triggering this if you do not call :func:`addstr`
+ with a *str* that has embedded newlines. Instead, call :func:`addstr`
+ separately for each line.
.. method:: window.attroff(attr)
diff --git a/Misc/NEWS.d/next/Documentation/2019-05-08-13-17-44.bpo-35924.lqbNpW.rst b/Misc/NEWS.d/next/Documentation/2019-05-08-13-17-44.bpo-35924.lqbNpW.rst
new file mode 100644
index 000000000000..a88778f85cce
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2019-05-08-13-17-44.bpo-35924.lqbNpW.rst
@@ -0,0 +1,2 @@
+Add a note to the ``curses.addstr()`` documentation to warn that multiline
+strings can cause segfaults because of an ncurses bug.
More information about the Python-checkins
mailing list