X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;h=4398f634efd8cf99ebd7dd407d355aebc07f8657;hb=152c5a605234b7ea36ba3a03ec07e124bb6aac75;hp=c958a849858b97d1951bb0334d974069ee734915;hpb=cb4427a16794d98049b4d790b810d62217501f9f;p=ncurses.git diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index c958a849..4398f634 100644 --- a/doc/html/man/curs_termcap.3x.html +++ b/doc/html/man/curs_termcap.3x.html @@ -1,6 +1,7 @@ @@ -47,7 +48,7 @@

NAME

        PC, UP, BC, ospeed, tgetent, tgetflag, tgetnum, tgetstr, tgoto, tputs -
-       direct curses interface to the terminfo capability database
+       curses emulation of termcap
 
 
 

SYNOPSIS

@@ -59,17 +60,17 @@
        extern char * BC;
        extern short ospeed;
 
-       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));
+       int tgetent(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));
 
 
 

DESCRIPTION

        These routines are included as a conversion aid for programs  that  use
-       the  termcap  library.   Their parameters are the same and the routines
+       the  termcap  library.  Their parameters are the same, but the routines
        are emulated using the terminfo database.  Thus, they can only be  used
        to  query  the  capabilities  of entries for which a terminfo entry has
        been compiled.
@@ -194,6 +195,8 @@
 
 
 

PORTABILITY

+
+

Standards

        These functions are provided for supporting  legacy  applications,  and
        should not be used in new programs:
 
@@ -212,6 +215,8 @@
        bility  with the termcap library, that is a defect in XCurses, Issue 4,
        Version 2 rather than in ncurses.
 
+
+

Compatibility with BSD Termcap

        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-
@@ -236,9 +241,63 @@
            against extended capability names which are longer than two charac-
            ters.
 
+       The BSD termcap function tgetent returns the text of a termcap entry in
+       the  buffer  passed  as an argument.  This library (like other terminfo
+       implementations) does not store terminal descriptions as text.  It sets
+       the buffer contents to a null-terminated string.
+
+
+

Other Compatibility

+       This  library includes a termcap.h header, for compatibility with other
+       implementations.  But the header is rarely used because the  other  im-
+       plementations are not strictly compatible.
+
+       The original BSD termcap (through 4.3BSD) had no header file which gave
+       function prototypes, because that was a feature of ANSI C.  BSD termcap
+       was  written  several  years before C was standardized.  However, there
+       were two different termcap.h header files in the BSD sources:
+
+       o   One was used internally by the jove editor in 2BSD through  4.4BSD.
+           It defined global symbols for the termcap variables which it used.
+
+       o   The  other  appeared in 4.4BSD Lite Release 2 (mid-1993) as part of
+           libedit (also known as the editline library).  The CSRG source his-
+           tory  shows  that  this  was added in mid-1992.  The libedit header
+           file was used internally, as a convenience for compiling the  edit-
+           line library.  It declared function prototypes, but no global vari-
+           ables.
+
+       The header file from libedit was added to NetBSD's termcap  library  in
+       mid-1994.
+
+       Meanwhile,  GNU  termcap  was under development, starting in 1990.  The
+       first release (termcap 1.0) in 1991 included a termcap.h  header.   The
+       second  release  (termcap 1.1) in September 1992 modified the header to
+       use const for the function prototypes in the header where one would ex-
+       pect  the parameters to be read-only.  This was a difference versus the
+       original BSD termcap.  The prototype for tputs also  differed,  but  in
+       that instance, it was libedit which differed from BSD termcap.
+
+       A copy of GNU termcap 1.3 was bundled with bash in mid-1993, to support
+       the readline library.
+
+       A termcap.h file was provided in ncurses 1.8.1 (November  1993).   That
+       reflected influence by emacs (rather than jove) and GNU termcap:
+
+       o   it provided declarations for a few global symbols used by emacs
+
+       o   it provided function prototypes (using const).
+
+       o   a prototype for tparam (a GNU termcap feature) was provided.
+
+       Later (in mid-1996) the tparam function was removed from ncurses.  As a
+       result, there are differences between any of the four  implementations,
+       which  must  be  taken into account by programs which can work with all
+       termcap library interfaces.
+
 
 

SEE ALSO

-       curses(3x), terminfo(5), term_variables(3x), putc(3).
+       curses(3x), putc(3), term_variables(3x), terminfo(5).
 
        https://invisible-island.net/ncurses/tctest.html
 
@@ -260,7 +319,13 @@
 
 
  • RETURN VALUE
  • BUGS
  • -
  • PORTABILITY
  • +
  • PORTABILITY + +
  • SEE ALSO