X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;h=e5cbf02a108a716e1b704bc869567ec2898a5427;hp=55b21c16b396885a6014a2f056da309c10a36aab;hb=02c4e383be9337e73a0e75844dfd1047745adb28;hpb=74137fec04e130a88ef25618cf730af988a4f51a diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index 55b21c16..e5cbf02a 100644 --- a/doc/html/man/curs_termcap.3x.html +++ b/doc/html/man/curs_termcap.3x.html @@ -26,7 +26,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_termcap.3x,v 1.37 2018/01/23 10:14:38 tom Exp @ + * @Id: curs_termcap.3x,v 1.39 2018/04/07 20:51:27 tom Exp @ --> @@ -59,10 +59,10 @@ extern char * BC; extern short ospeed; - int tgetent(char *bp, const char *name); - int tgetflag(char *id); - int tgetnum(char *id); - char *tgetstr(char *id, char **area); + int tgetent(const char *bp, const char *name); + int tgetflag(const char *id); + int tgetnum(const char *id); + char *tgetstr(const char *id, char **area); char *tgoto(const char *cap, int col, int row); int tputs(const char *str, int affcnt, int (*putc)(int)); @@ -194,38 +194,45 @@
- The XSI Curses standard, Issue 4 describes these functions. However, - they are marked TO BE WITHDRAWN and may be removed in future versions. - - Neither the XSI Curses standard nor the SVr4 man pages documented the - return values of tgetent correctly, though all three were in fact re- - turned ever since SVr1. In particular, an omission in the XSI Curses - documentation has been misinterpreted to mean that tgetent returns OK - or ERR. Because the purpose of these functions is to provide compati- - bility with the termcap library, that is a defect in XCurses, Issue 4, + These functions are provided for supporting legacy applications, and + should not be used in new programs: + + o The XSI Curses standard, Issue 4 describes these functions. Howev- + er, they are marked TO BE WITHDRAWN and may be removed in future + versions. + + o X/Open Curses, Issue 5 (December 2007) marked the termcap interface + (along with vwprintw and vwscanw) as withdrawn. + + Neither the XSI Curses standard nor the SVr4 man pages documented the + return values of tgetent correctly, though all three were in fact re- + turned ever since SVr1. In particular, an omission in the XSI Curses + documentation has been misinterpreted to mean that tgetent returns OK + or ERR. Because the purpose of these functions is to provide compati- + bility with the termcap library, that is a defect in XCurses, Issue 4, Version 2 rather than in ncurses. External variables are provided for support of certain termcap applica- tions. However, termcap applications' use of those variables is poorly documented, e.g., not distinguishing between input and output. In par- - ticular, some applications are reported to declare and/or modify os- + ticular, some applications are reported to declare and/or modify os- peed. - The comment that only the first two characters of the id parameter are + The comment that only the first two characters of the id parameter are used escapes many application developers. The original BSD 4.2 termcap library (and historical relics thereof) did not require a trailing null - NUL on the parameter name passed to tgetstr, tgetnum and tgetflag. - Some applications assume that the termcap interface does not require + NUL on the parameter name passed to tgetstr, tgetnum and tgetflag. + Some applications assume that the termcap interface does not require the trailing NUL for the parameter name. Taking into account these is- sues: - o As a special case, tgetflag matched against a single-character - identifier provided that was at the end of the terminal descrip- + o As a special case, tgetflag matched against a single-character + identifier provided that was at the end of the terminal descrip- tion. You should not rely upon this behavior in portable programs. - This implementation disallows matches against single-character ca- + This implementation disallows matches against single-character ca- pability names. - o This implementation disallows matches by the termcap interface + o This implementation disallows matches by the termcap interface against extended capability names which are longer than two charac- ters.