--- $Id: INSTALL,v 1.27 1997/04/26 23:48:19 tom Exp $
+-- $Id: INSTALL,v 1.33 1999/09/18 23:04:36 tom Exp $
---------------------------------------------------------------------
How to install Ncurses/Terminfo on your system
---------------------------------------------------------------------
* sed
* BSD or System V style install (a script is enclosed)
+Ncurses has been also built in the OS/2 EMX environment.
+
INSTALLATION PROCEDURE:
1. First, decide whether you want ncurses to replace your existing library (in
See the BSD CONVERSION NOTES section below for a few more details.
6. The c++ directory has C++ classes that are built on top of ncurses and
- panels. You need to have c++ (and its libraries) installed before you can
+ panels. You must have c++ (and its libraries) installed before you can
compile and run the demo.
+ Use --without-cxx-binding to tell configure to not build the C++ bindings
+ and demo.
+
+ If you do not have C++, you must use the --without-cxx option to tell
+ the configure script to not attempt to determine the type of 'bool'
+ which may be supported by C++. IF YOU USE THIS OPTION, BE ADVISED THAT
+ YOU MAY NOT BE ABLE TO COMPILE (OR RUN) NCURSES APPLICATIONS WITH C++.
+
7. If you're running an older Linux, you must either (a) tell Linux that the
console terminal type is `linux' or (b) make a link to or copy of the
linux entry in the appropriate place under your terminfo directory, named
wish to use the --enable-getcap option. This option speeds up
termcap-based startups, at the expense of not allowing personal
termcap entries to reference the terminfo tree. See the code in
- ncurses/read_termcap.c for details.
+ ncurses/tinfo/read_termcap.c for details.
+
+ Note that if you have $TERMCAP set, ncurses will use that value
+ to locate termcap data. In particular, running from xterm will
+ set $TERMCAP to the contents of the xterm's termcap entry.
+ If ncurses sees that, it will not examine /etc/termcap.
Keyboard Mapping:
term(7) manual page included with this distribution for more on
conventions for choosing type names.
- Here are our recommended primary console names for the most important
- freeware UNIX distributions:
+ Here are some recommended primary console names:
linux -- Linux console driver
freebsd -- FreeBSD
earlier X11R5 entry (xterm-r5) is provided as well.
If you are running XFree86 version 3.2 (actually 3.1.2F and up), you
- should consider using the xterm-xf86-v32 entry, which adds ANSI color
+ should consider using the xterm-xf86-v32 (or later, the most recent
+ version is always named "xterm-xfree86") entry, which adds ANSI color
and the VT220 capabilities which have been added in XFree86. If you
are running a mixed network, however, where this terminal description
may be used on an older xterm, you may have problems, since
By default, there are no entries on the fallback list. After you
have built the ncurses suite for the first time, you can change
- the list (the process needs infocmp(1)). To do so, use the
- script MKfallback.sh.
+ the list (the process needs infocmp(1)). To do so, use the script
+ MKfallback.sh. A configure script option --with-fallbacks does this
+ (it accepts a comma-separated list of the names you wish, and does
+ not require a rebuild).
If you wanted (say) to have linux, vt100, and xterm fallbacks, you
would use the commands
already be applied in your sources -- check for the #define TERMINFO.
USING NCURSES WITH GPM:
- Ncurses 4.1 can be configured to use GPM (General Purpose Mouse) which
- is used on Linux console. Be aware that GPM is commonly installed as a
- shared library which contains a wrapper for the curses wgetch()
- function (libcurses.o). Some integrators have simplified linking
- applications by combining all of libcurses.so (the BSD curses) into
- the libgpm.so file, producing symbol conflicts with ncurses. You may
- be able to work around this problem by linking as follows:
+ Ncurses 4.1 and up can be configured to use GPM (General Purpose Mouse)
+ which is used on Linux console. Be aware that GPM is commonly
+ installed as a shared library which contains a wrapper for the curses
+ wgetch() function (libcurses.o). Some integrators have simplified
+ linking applications by combining all of libcurses.so (the BSD curses)
+ into the libgpm.so file, producing symbol conflicts with ncurses. You
+ may be able to work around this problem by linking as follows:
cc -o foo foo.o -lncurses -lgpm -lncurses
ftp.clark.net:/pub/dickey/ncurses/gpm-1.10-970125.tgz
+ This patch is incorporated in gpm 1.12; however some integrators
+ are slow to update this library.
+
USING NCURSES WITH ELVIS:
To use ncurses as the screen-painting library for Elvis, apply the
following patch to the Elvis curses
BUGS:
Send any feedback to the ncurses mailing list at
- ncurses@bsdi.com. To subscribe send mail to
- ncurses-request@mailgate.bsdi.com with body that reads:
+ bug-ncurses@gnu.org. To subscribe send mail to
+ bug-ncurses-request@gnu.org with body that reads:
subscribe ncurses <your-email-address-here>
The Hacker's Guide in the misc directory includes some guidelines
on how to report bugs in ways that will get them fixed most quickly.
-