COMPILING NC/Linux
------------------
With the present test version of the makefile you must do some things
yourself in order to get NC/Linux running. First create a directory 'nc'
under your home directory. If you choose another name, you will have to
edit config.h and .nc_keys. Unpack the packed distribution
file into that directory and edit config.h and, perhaps,
.nc_keys. These files contain some comments on what the entries
mean. .nc_keys is evaluated only at run-time, so you have not to
recompile NC/Linux if you change it. The makefile assumes you have 'g++',
the GNU C++ compiler and linker. Remember, this is only an alpha version,
many of the things in config.h will later be configured in some other
(and less painful) way. Then, issue the following commands:

make clean
make
make install

Please ignore any LaTeX warnings.  

If you compiled nc as a regular user you will have to install the manpage
manually. If you compiled it as "root", the Makefile will copy the manpage
to the right location for you.

After this, set a path to the directory where the executables 'nc',
'hd', 'del', 'undel' and 'ncds' are located (or make links to them in a
directory that is in your path). 

If you want to use NCD as a standalone utility, you should define an alias
for ncd as described in the manpage.

If you want to use NC/Linux with resolutions other than 80x25, you
must define the environment variables LINES and COLS before you start
NC/Linux.  If these variables are not defined or do not have
reasonable values, NC/Linux will default to 80x25.

Finally, remove any aliases from your .profile that define 'del' (if
there are any), because 'del' is a program of the NC/Linux package and
it should *not* be an alias for 'rm' or something like that.

* NOTE 
* del/undel were removed from this version, because of some heavy bugs. 
* Please ignore any sections about these commands in the documentation.
* They will be supported in the near future again.


Also you must have a working ncurses 1.8 or newer installation. BSD curses
will *not* do, sorry. 
You can get ncurses from many major ftp sites,
including ftp.netcom.com in the directory pub/zmbenhal. Please make
sure that the test programs that come with ncurses work, before
attempting to run NC/Linux. If the test programs fail to operate, you do not
have a working ncurses installation and you can't expect NC/Linux to work.
For problems with ncurses please contact its author,
zmbenhal@netcom.com

*** IMPORTANT: ***
Read the manpage before you start working with NC/Linux.


TROUBLESHOOTING
---------------

Could not open file
-------------------
One error is often reported by new NC/Linux users: if NC/Linux prints 
right after the copyright screen the message "couldn't open file" 
and exits, then you have an old ncurses version. 
In such a case, please update to a new version (1.8 or newer).


Segment violation and the real time clock
-----------------------------------------
Another problem appears when you compile NC/Linux with the real
time clock functions enabled under a Linux kernel older than
99p13: you will get some funny characters printed out to the
command line every second and NC/Linux will crash after a while.
This has something to do with broken signal handling in older 
kernels. You can turn off the clock in "config.h" or upgrade
your kernel to 99p13 or newer.


term.h and unctrl.h not found
-----------------------------
This is an error that occurs when you "make" NC/Linux on a Slackware
system (and perhaps others too). Solution: make symbolic links from
/usr/include/ncurses/* to /usr/include and recompile:

ln -s /usr/include/ncurses/* /usr/include









