X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_getstr.3x;h=5f1601301f5bda484efde918f9d9bfeaa7fdf15f;hb=a4dac84af1b18fb24d56d6251deeb3c61c437158;hp=e8fbbc6df76070be38d64e68360193b183d1ec0a;hpb=58552e8c761a70f8f0bd591fecdf576fa8216e3e;p=ncurses.git diff --git a/man/curs_getstr.3x b/man/curs_getstr.3x index e8fbbc6d..5f160130 100644 --- a/man/curs_getstr.3x +++ b/man/curs_getstr.3x @@ -26,8 +26,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getstr.3x,v 1.20 2017/01/07 19:25:15 tom Exp $ +.\" $Id: curs_getstr.3x,v 1.22 2017/05/30 21:08:31 tom Exp $ .TH curs_getstr 3X "" +.ie \n(.g .ds `` \(lq +.el .ds `` `` +.ie \n(.g .ds '' \(rq +.el .ds '' '' .na .hy 0 .SH NAME @@ -81,7 +85,7 @@ backspace is echoed as deletion of the previous character (typically a left motion). .SH RETURN VALUE All routines return the integer \fBERR\fR upon failure and an \fBOK\fR (SVr4 -specifies only "an integer value other than \fBERR\fR") upon successful +specifies only \*(``an integer value other than \fBERR\fR\*('') upon successful completion. .PP X/Open defines no error conditions. @@ -92,10 +96,10 @@ if the window pointer is null, or if its timeout expires without having any data. .PP This implementation provides an extension as well. -If a SIGWINCH interrupts the function, it will return \fBKEY_RESIZE\fP +If a \fBSIGWINCH\fP interrupts the function, it will return \fBKEY_RESIZE\fP rather than \fBOK\fP or \fBERR\fP. .PP -Functions with a "mv" prefix first perform a cursor movement using +Functions with a \*(``mv\*('' prefix first perform a cursor movement using \fBwmove\fP, and return an error if the position is outside the window, or if the window pointer is null. .SH NOTES @@ -108,9 +112,14 @@ This implementation returns ERR if the window pointer is null, or if the lower-level \fBwgetch\fR(3X) call returns an ERR. .PP SVr3 and early SVr4 curses implementations did not reject function keys; -the SVr4.0 documentation claimed that "special keys" (such as function -keys, "home" key, "clear" key, \fIetc\fR.) are "interpreted", without -giving details. It lied. In fact, the `character' value appended to the +the SVr4.0 documentation claimed that \*(``special keys\*('' +(such as function keys, +\*(``home\*('' key, +\*(``clear\*('' key, +\fIetc\fR.) are \*(``interpreted\*('', +without giving details. +It lied. +In fact, the \*(``character\*('' value appended to the string by those implementations was predictable but not useful (being, in fact, the low-order eight bits of the key's KEY_ value). .PP