Return to README CVS log

Up to [Research Unix] / researchv10no / ncurses / screen

Annotation of researchv10no/ncurses/screen/README, revision 1.1.1.1

1.1       root        1:                Curses/Terminfo distribution
                      2: 
                      3: THIS CODE IS PROPRIETARY TO BELL LABS.  DO NOT GIVE IT TO ANYONE ELSE.
                      4: 
                      5: You have a distribution of curses and terminfo.  This is the second
                      6: internal distribution of curses.  To find the version, look in
                      7: screen/curses.c for a version number.
                      8: 
                      9: To report bugs, if at all possible, demonstrate the bug in the form
                     10: of a "show script", that is, a 2 page (often 48 line) file which
                     11: will cause the show program to mess up.  If a simple modification
                     12: to show will illustrate the bug, this is second choice.  Otherwise,
                     13: please write a small program that illustrates the bug.  Huge programs
                     14: that "don't work" are unlikely to get much sympathy.
                     15: 
                     16: To install curses, be guided by the makefiles.  You can use the
                     17: makefile in this directory.  Do a "make all install".  Do not do "make clean"
                     18: until the install completes.  This will not install any manual pages
                     19: or demos - they are up to you to install by hand if you want them.
                     20: 
                     21: If you are on a 16 bit machine, it will be necessary
                     22: to add the -i option to ../screen/makefile's compilation of tic.
                     23: (This has already been done for the PDP-11).
                     24: Otherwise, tic will dump core when trying to compile some terminals.
                     25: If you are on a small 11 without separate I/D, you'll have
                     26: to compile only those entries that don't use lots of use= indirection:
                     27: what's happening is that 3 or 4 levels of use= recursion runs out of
                     28: memory on the stack.
                     29: 
                     30: Now you can run programs using curses.  A sample program included in
                     31: the screen directory is show.c, say "make show" and it will compile.
                     32: "show" is a paging program - you hit space to go on to the next page.
                     33: You can use show to make sure everything works.  (Be sure you have TERM
                     34: set in your environment.  TERMCAP is no longer necessary.)  A fancier
                     35: demo can be found in the demo directory.
                     36: 
                     37: If you add or change terminfo descriptions in the terminfo directory,
                     38: you can run compile on the single source file, instead of on terminfo.src.
                     39: Since the compiler is so slow, it's worthwhile to only run it on
                     40: one source file.
                     41: 
                     42: If you add capabilities
                     43: you should edit screen/caps.  Be sure to add the capabilties
                     44: at the END of the section (bools, nums, or strings) as this will
                     45: preserve compatibility with older binaries.  Then run "make term.h",
                     46: "make clean", and recompile the library.
                     47: 
                     48: For debugging, the makefile will create several other versions of curses.
                     49: In addition to the .c (source) and .o (object) files, there are .p's
                     50: for profiling, .d's for debugging, and .t's for tracing.  These will
                     51: create dlibcurses.a, plibcurses.a, and tlibcurses.a.  The d version
                     52: defines DEBUG and uses the -g flag for sdb.  DEBUG causes the file "trace"
                     53: to be created in the current directory when you run a program with curses.
                     54: This can be installed as -lcurses if you wish.  The t version defines
                     55: DEBUG for tracing, but doesn't use -g, so it's faster to compile, but
                     56: won't help much if core dumps.
                     57: 
                     58: A recent addition is screen/termcap.c (made from screen/termcap.form
                     59: and screen/caps) which emulates the older termcap library.  This is
                     60: intended only as a conversion aid, but it is complete enough to enable
                     61: vi 3.7 (the last termcap version) to run using terminfo.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.