---------------------------------------------------------------------
             How to install Ncurses/Terminfo on your system 
---------------------------------------------------------------------
************************************************************
* READ ALL OF THIS FILE BEFORE YOU TRY AND INSTALL NCURSES.*
************************************************************

Assumptions: You have unpacked the distribution into an empty directory.
You found this file in a subdirectory of that one called 'doc'.
There are several other subdirectories, called 'src', 'test', 'data'.

You need the following in order to build and install ncurses:
gcc or other ANSI C compiler
sh (bash will do)
awk
sed

1.  It is an unfortunate fact of life that your have to configure things
    differently on different operating system. OS and setup configuration
    is done in a file called Config.<os-name> in the src directory.
    These file are generated automatically when you run the src/Configure
    script, and so is the appropriate makefile.
    If your operating system is not supported, read the file src/README
    for information on how to create a configuration file for your system.

2.  Read and edit src/Makefile to suit your local setup.

3.  Decide where you want to put the object files of terminal descriptions
    and the tic/untic programs in.  On my system (and I recommend it for
    you), the directory /usr/lib/terminfo is used.  If you really can't 
    stand the idea (remember, this is not where the C language source 
    code to the library will go; this is where the actual binary terminal
    descriptions will go), you'll need to do these steps (skip these if 
    you're being reasonable or lazy):
	a. Keep in mind that this directory should probably be
	   in your root filesystem so that programs which use terminfo
	   can be used even when the system is only up single-user.
	b. Change the value of the variable SRCDIR in src/Config.<os-name>
	   to the name of the directory you've chosen.
	c. Change the man pages in doc to reflect the name-change.

4.  Type 'make'.  Ignore any warnings, no error-messages should be produced.
    This should compile the versions of the library you selected in 
    Config.<os-name>, the terminfo compiler (tic) and the untic program. 

5.  There are 3 parts to installing ncurses:
	'make install.libs' installs the headers and libraries.
	'make install.man' installs the man pages.
	'make install.data' installs the terminfo database. You can skip this
		part if your system already has such a database.
	'make alias' will link ncurses.h and nterm.h to curses.h and term.h

6.  Change to the subdirectory test and type 'make all'.  This should compile
    all of the test programs  in the release.  Once again, there should be
    no errors. You'll get lots of warnings, just ignore them. Read the
    file test/README for details on what to expect.

7.  Also included is a modified copy of Warren Tucker's implementation 
    of PANELS. If you wish to install it, change into panel and type 'make 
    install'.

8.  The c++ directory has C++ classes that are built on top of ncurses and
	panels. You need to have installed panels to compile and run the demo.

NOTES:

	If you have SLS or anything based on it (slackware is OK) PLEASE
	remove everything related to ncurses before re-installing it.

	Programming with ncurses involves including the <ncurses.h> header
	file and linking with -lncurses. This distinguishes it from any
	existing curses package on your system.

	Existing programs that use curses include <curses.h>. There are two
	approaches to handling this:
	1) change all the <curses.h> to <ncurses.h>.
	2) use the 'make alias' option.

	If you have bsd curses installed in your system and you accidentally
	compile using its curses.h you'll end up with a large number of
	undefined symbols at link time. _waddbytes is one of them.

	The header file <nterm.h> has been included so that programs
    which work only at the terminfo-level need not worry about name
	conflicts with the rest of the package. By including <nterm.h> 
	instead of <ncurses.h>,  they will get everything needed for the 
	terminfo-level routines.

	[N.B. nterm.h is one of several file built automatically by make. see
	src/Makefile]

AUTHORS:
	Pavel Curtis, original ncurses
	Zeyd M. Ben-Halim, Port of original to Linux and modifications henceforth.
	Gerhard Feurnkranz, the slk_* functions.
	Warren Tucker, the PANELS library.
	Eric Newton, Ulrich Drepper, and Anatoly Ivasyuk, the C++ code.
	Eric S. Raymond, the man pages and src/lib_twait.c

BUGS:
	Send any feedback to me: zmbenhal@netcom.com or better still join the
	ncurses mailing list. send a message to ncurses-list-requests@cs.tu-berlin.de
	asking to be added.


