---------------------------------------------------------------------
             How to install Curses/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
bsd based install (FSF has one)

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.
    If your operating system is supported then read that file and make
    any changes to fit your local setup. See step 3 for more details.
    If your operating system is not supported, you can use the file
    =src/Config as a starting point.

2.  If you are satisfied with your configuration run the script =src/Configure.
    this will create a Makefile for you to use.

3.  Decide where you want to put the object files and source files
    of terminal descriptions.  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 terminal
    descriptions and their object files 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.  Change to the subdirectory =src and 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. Then type 'make install' to install ncurses
    in the directories defined in Config.<os-name>.

5.  Doing 'make install' will also compile the terminfo entries in =data
    and install them in the SRCDIR defined in Config.<os-name>.
    N.B. Some operating systems already have support for terminfo. In this
    	case you probably wouldn't want to install the terminfo entries
    	supplied with ncurses. type 'make install.libs' instead.

6.  Change to the subdirectory =test and type 'make'.  This should compile
    all of the test programs  in the release.  Once again, there should be
    no errors.

NOTES:

	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) make a link /usr/local/include/curses.h to ncurses.h and use
	   -I/usr/local/lib when compiling.
	The second approach is used be default; see =src/Config.

	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 <term.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 <term.h> 
	instead of <ncurses.h>,  they will get everything needed for the 
	terminfo-level routines.

	[N.B. term.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.

BUGS:
	Send any feedback to me: zmbenhal@netcom.com


