X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_termcap.3x.html;h=a1d532c4f13335bc194cb945ba3175908098b0cb;hp=ffbbc765771f24551c84c4dfe041953c387d9592;hb=14d46fadc442db9df4567357cda396235418120e;hpb=0de8912c1c0746eb37b733e9e6fdf852aab9506a diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index ffbbc765..a1d532c4 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,12 +60,12 @@
        extern char * BC;
        extern short ospeed;
 
-       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));
+       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

@@ -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,6 +241,60 @@
            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).
@@ -260,7 +319,13 @@
 
 
  • RETURN VALUE
    • 
 
  • BUGS
    • 
-
  • PORTABILITY
    • 
+
  • PORTABILITY
+
+
    • 
 
  • SEE ALSO
    •