[Python-checkins] [2.7] bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179) (GH-6405)
Ned Deily
webhook-mailer at python.org
Fri Apr 6 22:01:38 EDT 2018
https://github.com/python/cpython/commit/77f0a41d72886513f5e9277e5587455745c29ac1
commit: 77f0a41d72886513f5e9277e5587455745c29ac1
branch: 2.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Ned Deily <nad at python.org>
date: 2018-04-06T22:01:35-04:00
summary:
[2.7] bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179) (GH-6405)
(cherry picked from commit ef5ce884a41c8553a7eff66ebace908c1dcc1f89)
Co-authored-by: Jay Crotts <crotts.jay at gmail.com>
files:
A Misc/NEWS.d/next/Documentation/2018-01-13-20-30-53.bpo-8243.s98r28.rst
M Doc/library/curses.rst
diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
index b36b9d73e353..5ea246b83fe2 100644
--- a/Doc/library/curses.rst
+++ b/Doc/library/curses.rst
@@ -663,6 +663,12 @@ the following methods:
character previously painter at that location. By default, the character
position and attributes are the current settings for the window object.
+ .. note::
+
+ Writing outside the window, subwindow, or pad raises a :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 character is printed.
+
.. method:: window.addnstr(str, n[, attr])
window.addnstr(y, x, str, n[, attr])
@@ -677,6 +683,12 @@ the following methods:
Paint the string *str* at ``(y, x)`` with attributes *attr*, overwriting
anything previously on the display.
+ .. 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.
+
.. method:: window.attroff(attr)
diff --git a/Misc/NEWS.d/next/Documentation/2018-01-13-20-30-53.bpo-8243.s98r28.rst b/Misc/NEWS.d/next/Documentation/2018-01-13-20-30-53.bpo-8243.s98r28.rst
new file mode 100644
index 000000000000..a3520d05c095
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-01-13-20-30-53.bpo-8243.s98r28.rst
@@ -0,0 +1,2 @@
+Add a note about curses.addch and curses.addstr exception behavior when
+writing outside a window, or pad.
More information about the Python-checkins
mailing list