X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;fp=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;h=a861edd8c08ca0e74642cb54832ae7f9296733bc;hp=2efd40c768cd8a1f1ee19411f96647d06c9ba059;hb=2882050bf8b296813e7e026b1c5c45d4a23043e3;hpb=894a177fd5228cdbe790bd1dc9435bd435c29681 diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index 2efd40c7..a861edd8 100644 --- a/doc/html/man/curs_termcap.3x.html +++ b/doc/html/man/curs_termcap.3x.html @@ -27,19 +27,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_termcap.3x,v 1.69 2023/10/07 21:19:07 tom Exp @ + * @Id: curs_termcap.3x,v 1.70 2023/10/14 19:26:28 tom Exp @ -->
-curs_termcap(3x) Library calls curs_termcap(3x) @@ -215,38 +215,6 @@ an error. -
- If you call tgetstr to fetch ca or any other parameterized string, be - aware that it will be returned in terminfo notation, not the older and - not-quite-compatible termcap notation. This will not cause problems if - all you do with it is call tgoto or tparm, which both expand terminfo- - style strings as terminfo. (The tgoto function, if configured to - support termcap, will check if the string is indeed terminfo-style by - looking for "%p" parameters or "$<..>" delays, and invoke a termcap- - style parser if the string does not appear to be terminfo). - - Because terminfo conventions for representing padding in string - capabilities differ from termcap's, users can be surprised: - - o tputs("50") in a terminfo system will put out a literal "50" rather - than busy-waiting for 50 milliseconds. - - o However, if ncurses is configured to support termcap, it may also - have been configured to support the BSD-style padding. - - In that case, tputs inspects strings passed to it, looking for - digits at the beginning of the string. - - tputs("50") in a termcap system may wait for 50 milliseconds rather - than put out a literal "50" - - Note that termcap has nothing analogous to terminfo's sgr string. One - consequence of this is that termcap applications assume me (terminfo - sgr0) does not reset the alternate character set. This implementation - checks for, and modifies the data shown to the termcap interface to - accommodate termcap's limitation in this respect. - -
@@ -349,6 +317,39 @@ termcap library interfaces. +
+ If you call tgetstr to fetch ca or any other parameterized string + capability, be aware that it is returned in terminfo notation, not the + older and not-quite-compatible termcap notation. This does not cause + problems if all you do with it is call tgoto or tparm, which both + expand terminfo-style strings as terminfo does. (The tgoto function, + if configured to support termcap, checks if the string is indeed + terminfo-style by looking for "%p" parameters or "<...>" delays, and + invokes a termcap-style parser if the string appears not to use + terminfo syntax.) + + Because terminfo's syntax for padding in string capabilities differs + from termcap's, users can be surprised. + + o tputs("50") in a terminfo system transmits "50" rather than busy- + waiting for 50 milliseconds. + + o However, if ncurses is configured to support termcap, it may also + have been configured to support BSD-style padding. + + In that case, tputs inspects strings passed to it, looking for + digits at the beginning of the string. + + tputs("50") in a termcap system may busy-wait for 50 milliseconds + rather than transmitting "50". + + termcap has nothing analogous to terminfo's sgr string. One + consequence is that termcap applications assume that me (equivalent to + terminfo's sgr0 capability) does not reset the alternate character set. + ncurses checks for, and modifies the data shared with, the termcap + interface to accommodate the latter's limitation in this respect. + +
curses(3x), putc(3), term_variables(3x), terminfo(5) @@ -356,7 +357,7 @@ -ncurses 6.4 2023-10-07 curs_termcap(3x) +ncurses 6.4 2023-10-14 curs_termcap(3x)