X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getstr.3x.html;h=76b23fa80c4a0686e992dc7e217a78d3a638fec9;hb=265e45e43e9917e8b9ecc2bf9d23867a3ede2ecd;hp=efca02f3275892b255437ebbb82375f05cd6d632;hpb=45a2b5bc1a4536173178e9907feb268c708797c7;p=ncurses.git
diff --git a/doc/html/man/curs_getstr.3x.html b/doc/html/man/curs_getstr.3x.html
index efca02f3..76b23fa8 100644
--- a/doc/html/man/curs_getstr.3x.html
+++ b/doc/html/man/curs_getstr.3x.html
@@ -27,7 +27,7 @@
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: curs_getstr.3x,v 1.32 2021/05/15 23:37:18 tom Exp @
+ * @Id: curs_getstr.3x,v 1.33 2021/05/22 21:36:35 tom Exp @
* X/Open says also until EOf
* X/Open says then an EOS is added to the result
* X/Open doesn't mention n<0
@@ -193,13 +193,25 @@
o On return, getnstr restores the modes to their previous values.
- Other implementations differ. While they may set the echo mode, they
- do not modify the raw mode, and may take the cbreak mode set by the
- caller into account when deciding whether to handle echoing within
- getnstr or as a side-effect of the getch calls. Because ncurses sets
- these modes, its signal handlers for INTR and QUIT (e.g., ^C or ^\) may
- catch a signal and stop the program, where other implementations allow
- one to enter those characters in the buffer.
+ Other implementations differ in their treatment of special characters:
+
+ o While they may set the echo mode, other implementations do not mod-
+ ify the raw mode, They may take the cbreak mode set by the caller
+ into account when deciding whether to handle echoing within getnstr
+ or as a side-effect of the getch calls.
+
+ o The original ncurses (as pcurses in 1986) set noraw and cbreak when
+ accepting input for getnstr. That may have been done to make func-
+ tion- and cursor-keys work; it is not necessary with ncurses.
+
+ Since 1995, ncurses has provided signal handlers for INTR and QUIT
+ (e.g., ^C or ^\). With the noraw and cbreak settings, those may
+ catch a signal and stop the program, where other implementations
+ allow one to enter those characters in the buffer.
+
+ o Starting in 2021 (ncurses 6.3), getnstr sets raw, rather than noraw
+ and cbreak for better compatibility with SVr4-curses, e.g., allow-
+ ing one to enter a ^C into the buffer.