@@ -302,9 +302,11 @@ The module :mod:`!curses` defines the following functions:
302302
303303 Used for half-delay mode, which is similar to cbreak mode in that characters
304304 typed by the user are immediately available to the program. However, after
305- blocking for *tenths * tenths of seconds, raise an exception if nothing has
306- been typed. The value of *tenths * must be a number between ``1 `` and ``255 ``. Use
307- :func: `nocbreak ` to leave half-delay mode.
305+ blocking for *tenths * tenths of seconds, if nothing has been typed,
306+ :meth: `~window.getch ` returns ``-1 ``, while :meth: `~window.getkey ` and
307+ :meth: `~window.get_wch ` raise :exc: `curses.error `.
308+ The value of *tenths * must be a number between ``1 `` and ``255 ``.
309+ Use :func: `nocbreak ` to leave half-delay mode.
308310
309311
310312.. function :: init_color(color_number, r, g, b)
@@ -639,8 +641,10 @@ The module :mod:`!curses` defines the following functions:
639641
640642.. function :: termname()
641643
642- Return the value of the environment variable :envvar: `TERM `, as a bytes object,
643- truncated to 14 characters.
644+ Return the name of the terminal in use, as a bytes object.
645+ This is the name passed to :func: `setupterm `,
646+ or the value of the :envvar: `TERM ` environment variable if none was given.
647+ Some curses libraries truncate it to 14 characters.
644648
645649
646650.. function :: tigetflag(capname)
@@ -1148,7 +1152,8 @@ Window objects
11481152 Insert character *ch * with attributes *attr * before the character under the
11491153 cursor, or at ``(y, x) `` if specified. All characters to the right of the
11501154 cursor are shifted one position right, with the rightmost character on the
1151- line being lost. The cursor position does not change.
1155+ line being lost.
1156+ The cursor position does not change (after moving to *y *, *x *, if specified).
11521157
11531158
11541159.. method :: window.insdelln(nlines)
@@ -1170,8 +1175,8 @@ Window objects
11701175 window.insnstr(y, x, str, n[, attr])
11711176
11721177 Insert a character string (as many characters as will fit on the line) before
1173- the character under the cursor, up to *n * characters. If *n * is zero or
1174- negative, the entire string is inserted. All characters to the right of the
1178+ the character under the cursor, up to *n * characters. If *n * is negative,
1179+ the entire string is inserted. All characters to the right of the
11751180 cursor are shifted right, with the rightmost characters on the line being lost.
11761181 The cursor position does not change (after moving to *y *, *x *, if specified).
11771182
@@ -1345,8 +1350,9 @@ Window objects
13451350.. method :: window.scroll([lines=1])
13461351
13471352 Scroll the screen or scrolling region. Scroll upward by *lines * lines if
1348- *lines * is positive, or downward if it is negative. Scrolling has no effect
1349- unless it has been enabled for the window with :meth: `scrollok `.
1353+ *lines * is positive, or downward if it is negative.
1354+ Raise :exc: `curses.error ` unless scrolling has been enabled for the window
1355+ with :meth: `scrollok `.
13501356
13511357
13521358.. method :: window.scrollok(flag)
0 commit comments