Imported from ../bash-3.2.48.tar.gz.
[platform/upstream/bash.git] / lib / termcap / grot / README
1 This is the GNU termcap library -- a library of C functions that
2 enable programs to send control strings to terminals in a way
3 independent of the terminal type.  The GNU termcap library does not
4 place an arbitrary limit on the size of termcap entries, unlike most
5 other termcap libraries.
6
7 Most of this package is also distributed with GNU Emacs, but it is
8 available in this separate distribution to make it easier to install
9 as -ltermcap.  However, use of termcap is discouraged.  Termcap is
10 being phased out in favor of the terminfo-based ncurses library, which
11 contains an emulation of the termcap library routines in addition to
12 an excellent curses implementation.  ncurses is available from the
13 usual GNU archive sites.
14
15 See the file INSTALL for compilation and installation instructions.
16 Additionally:
17
18 This package contains termcap.src, the latest official termcap data
19 file.  By default, it is not installed.  The current version contains
20 some entries that are more than 1023 bytes long, which is the largest
21 value that is safe to use with the many historical applications that
22 only allocate a 1024 byte termcap buffer (telnet, for example).  If
23 you make sure that all of your programs allocate buffers of at least
24 2500 bytes, or let the termcap library do it by passing a NULL
25 pointer, then it is safe to install the new termcap file, as described
26 below.
27
28 You can give configure two special options:
29   --enable-install-termcap install the termcap data file
30   --with-termcap=FILE     use data file FILE instead of /etc/termcap
31
32 Please report any bugs in this library to bug-gnu-emacs@prep.ai.mit.edu.
33 You can check which version of the library you have by using the RCS
34 `ident' command on libtermcap.a.