home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1996 May / PCOnline_05_1996.bin / linux / source / contrib / ncurses-.8 / ncurses-.002 / ncurses- / ncurses-1.8.5 / INSTALL < prev    next >
Text File  |  1994-02-20  |  5KB  |  106 lines
  1. ---------------------------------------------------------------------
  2.              How to install Ncurses/Terminfo on your system 
  3. ---------------------------------------------------------------------
  4. ************************************************************
  5. * READ ALL OF THIS FILE BEFORE YOU TRY AND INSTALL NCURSES.*
  6. ************************************************************
  7.  
  8. Assumptions: You have unpacked the distribution into an empty directory.
  9. You found this file in a subdirectory of that one called 'doc'.
  10. There are several other subdirectories, called 'src', 'test', 'data'.
  11.  
  12. You need the following in order to build and install ncurses:
  13. gcc or other ANSI C compiler
  14. sh (bash will do)
  15. awk
  16. sed
  17.  
  18. 1.  It is an unfortunate fact of life that your have to configure things
  19.     differently on different operating system. OS and setup configuration
  20.     is done in a file called Config.<os-name> in the src directory.
  21.     These file are generated automatically when you run the src/Configure
  22.     script, and so is the appropriate makefile.
  23.     If your operating system is not supported, read the file src/README
  24.     for information on how to create a configuration file for your system.
  25.  
  26. 2.  Read and edit src/Makefile to suit your local setup.
  27.  
  28. 3.  Decide where you want to put the object files of terminal descriptions
  29.     and the tic/untic programs in.  On my system (and I recommend it for
  30.     you), the directory /usr/lib/terminfo is used.  If you really can't 
  31.     stand the idea (remember, this is not where the C language source 
  32.     code to the library will go; this is where the actual binary terminal
  33.     descriptions will go), you'll need to do these steps (skip these if 
  34.     you're being reasonable or lazy):
  35.     a. Keep in mind that this directory should probably be
  36.        in your root filesystem so that programs which use terminfo
  37.        can be used even when the system is only up single-user.
  38.     b. Change the value of the variable SRCDIR in src/Config.<os-name>
  39.        to the name of the directory you've chosen.
  40.     c. Change the man pages in doc to reflect the name-change.
  41.  
  42. 4.  Type 'make'.  Ignore any warnings, no error-messages should be produced.
  43.     This should compile the versions of the library you selected in 
  44.     Config.<os-name>, the terminfo compiler (tic) and the untic program. 
  45.  
  46. 5.  There are 3 parts to installing ncurses:
  47.     'make install.libs' installs the headers and libraries.
  48.     'make install.man' installs the man pages.
  49.     'make install.data' installs the terminfo database. You can skip this
  50.         part if your system already has such a database.
  51.     'make alias' will link ncurses.h and nterm.h to curses.h and term.h
  52.  
  53. 6.  Change to the subdirectory test and type 'make all'.  This should compile
  54.     all of the test programs  in the release.  Once again, there should be
  55.     no errors. You'll get lots of warnings, just ignore them. Read the
  56.     file test/README for details on what to expect.
  57.  
  58. 7.  Also included is a modified copy of Warren Tucker's implementation 
  59.     of PANELS. If you wish to install it, change into panel and type 'make 
  60.     install'.
  61.  
  62. 8.  The c++ directory has C++ classes that are built on top of ncurses and
  63.     panels. You need to have installed panels to compile and run the demo.
  64.  
  65. NOTES:
  66.  
  67.     If you have SLS or anything based on it (slackware is OK) PLEASE
  68.     remove everything related to ncurses before re-installing it.
  69.  
  70.     Programming with ncurses involves including the <ncurses.h> header
  71.     file and linking with -lncurses. This distinguishes it from any
  72.     existing curses package on your system.
  73.  
  74.     Existing programs that use curses include <curses.h>. There are two
  75.     approaches to handling this:
  76.     1) change all the <curses.h> to <ncurses.h>.
  77.     2) use the 'make alias' option.
  78.  
  79.     If you have bsd curses installed in your system and you accidentally
  80.     compile using its curses.h you'll end up with a large number of
  81.     undefined symbols at link time. _waddbytes is one of them.
  82.  
  83.     The header file <nterm.h> has been included so that programs
  84.     which work only at the terminfo-level need not worry about name
  85.     conflicts with the rest of the package. By including <nterm.h> 
  86.     instead of <ncurses.h>,  they will get everything needed for the 
  87.     terminfo-level routines.
  88.  
  89.     [N.B. nterm.h is one of several file built automatically by make. see
  90.     src/Makefile]
  91.  
  92. AUTHORS:
  93.     Pavel Curtis, original ncurses
  94.     Zeyd M. Ben-Halim, Port of original to Linux and modifications henceforth.
  95.     Gerhard Feurnkranz, the slk_* functions.
  96.     Warren Tucker, the PANELS library.
  97.     Eric Newton, Ulrich Drepper, and Anatoly Ivasyuk, the C++ code.
  98.     Eric S. Raymond, the man pages and src/lib_twait.c
  99.  
  100. BUGS:
  101.     Send any feedback to me: zmbenhal@netcom.com or better still join the
  102.     ncurses mailing list. send a message to ncurses-list-requests@cs.tu-berlin.de
  103.     asking to be added.
  104.  
  105.  
  106.