X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;h=178efe78afa6f423f6555304741ba6b37939839f;hp=a51993397750069c732fc61d7267e88eb91a4a42;hb=e2d7d0028f4298dca2b0edaf2dc8ce30518d9218;hpb=448c4dbefe6aa9604a5a8cefa3b3596b3ddb4b78 diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index a5199339..178efe78 100644 --- a/doc/html/man/curs_termcap.3x.html +++ b/doc/html/man/curs_termcap.3x.html @@ -1,7 +1,7 @@ @@ -79,29 +79,32 @@ bilities of entries for which a terminfo entry has been compiled. + INITIALIZATION The tgetent routine loads the entry for name. It returns: 1 on success, - 0 if there is no such entry (or that it is a generic - type, having too little information for curses ap- + 0 if there is no such entry (or that it is a generic + type, having too little information for curses ap- plications to run), and -1 if the terminfo database could not be found. This differs from the termcap library in two ways: - - The emulation ignores the buffer pointer bp. The - termcap library would store a copy of the terminal - description in the area referenced by this pointer. - However, ncurses stores its terminal descriptions in - compiled binary form, which is not the same thing. + o The emulation ignores the buffer pointer bp. The + termcap library would store a copy of the terminal + description in the area referenced by this pointer. + However, ncurses stores its terminal descriptions + in compiled binary form, which is not the same + thing. - - There is a difference in return codes. The termcap - library does not check if the terminal description - is marked with the generic capability, or if the - terminal description has cursor-addressing. + o There is a difference in return codes. The termcap + library does not check if the terminal description + is marked with the generic capability, or if the + terminal description has cursor-addressing. + CAPABILITY VALUES The tgetflag routine gets the boolean entry for id, or ze- ro if it is not available. @@ -117,6 +120,7 @@ Only the first two characters of the id parameter of tget- flag, tgetnum and tgetstr are compared in lookups. + FORMATTING CAPABILITIES The tgoto routine instantiates the parameters into the given capability. The output from this routine is to be passed to tputs. @@ -125,6 +129,7 @@ manual page. It can retrieve capabilities by either term- cap or terminfo name. + GLOBAL VARIABLES The variables PC, UP and BC are set by tgetent to the ter- minfo entry's data for pad_char, cursor_up and backspace_if_not_bs, respectively. UP is not used by @@ -191,11 +196,33 @@ guishing between input and output. In particular, some applications are reported to declare and/or modify ospeed. + 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 the trailing NUL for the parameter name. Tak- + ing into account these issues: + + o As a special case, tgetflag matched against a single- + character identifier provided that was at the end of + the terminal description. You should not rely upon + this behavior in portable programs. This implementa- + tion disallows matches against single-character capa- + bility names. + + o This implementation disallows matches by the termcap + interface against extended capability names which are + longer than two characters. +

SEE ALSO

        curses(3x), terminfo(5), term_variables(3x), putc(3).
 
+       http://invisible-island.net/ncurses/tctest.html
+
 
 
                                                        curs_termcap(3x)