V10/ncurses/screen/README

		Curses/Terminfo distribution

THIS CODE IS PROPRIETARY TO BELL LABS.  DO NOT GIVE IT TO ANYONE ELSE.

You have a distribution of curses and terminfo.  This is the second
internal distribution of curses.  To find the version, look in
screen/curses.c for a version number.

To report bugs, if at all possible, demonstrate the bug in the form
of a "show script", that is, a 2 page (often 48 line) file which
will cause the show program to mess up.  If a simple modification
to show will illustrate the bug, this is second choice.  Otherwise,
please write a small program that illustrates the bug.  Huge programs
that "don't work" are unlikely to get much sympathy.

To install curses, be guided by the makefiles.  You can use the
makefile in this directory.  Do a "make all install".  Do not do "make clean"
until the install completes.  This will not install any manual pages
or demos - they are up to you to install by hand if you want them.

If you are on a 16 bit machine, it will be necessary
to add the -i option to ../screen/makefile's compilation of tic.
(This has already been done for the PDP-11).
Otherwise, tic will dump core when trying to compile some terminals.
If you are on a small 11 without separate I/D, you'll have
to compile only those entries that don't use lots of use= indirection:
what's happening is that 3 or 4 levels of use= recursion runs out of
memory on the stack.

Now you can run programs using curses.  A sample program included in
the screen directory is show.c, say "make show" and it will compile.
"show" is a paging program - you hit space to go on to the next page.
You can use show to make sure everything works.  (Be sure you have TERM
set in your environment.  TERMCAP is no longer necessary.)  A fancier
demo can be found in the demo directory.

If you add or change terminfo descriptions in the terminfo directory,
you can run compile on the single source file, instead of on terminfo.src.
Since the compiler is so slow, it's worthwhile to only run it on
one source file.

If you add capabilities
you should edit screen/caps.  Be sure to add the capabilties
at the END of the section (bools, nums, or strings) as this will
preserve compatibility with older binaries.  Then run "make term.h",
"make clean", and recompile the library.

For debugging, the makefile will create several other versions of curses.
In addition to the .c (source) and .o (object) files, there are .p's
for profiling, .d's for debugging, and .t's for tracing.  These will
create dlibcurses.a, plibcurses.a, and tlibcurses.a.  The d version
defines DEBUG and uses the -g flag for sdb.  DEBUG causes the file "trace"
to be created in the current directory when you run a program with curses.
This can be installed as -lcurses if you wish.  The t version defines
DEBUG for tracing, but doesn't use -g, so it's faster to compile, but
won't help much if core dumps.

A recent addition is screen/termcap.c (made from screen/termcap.form
and screen/caps) which emulates the older termcap library.  This is
intended only as a conversion aid, but it is complete enough to enable
vi 3.7 (the last termcap version) to run using terminfo.