xref: /original-bsd/share/termcap/README (revision bdac0c45)
1<< 14 October 1987 >>
2It is probably easiest to make local termcap changes in separate
3files, eg /usr/local/etc/termcap, and encourage people to put
4
5	setenv TERMPATH ~/.termcap:/usr/local/etc/termcap:/etc/termcap
6
7in their shell startup files.  This way local system-wide changes can be
8isolated in /usr/local/etc/termcap and user changes in ~/.termcap, all
9without consuming lots of disk or requiring re-integration of local
10changes when system termcap files change.
11
12	John Kunze
13	termcap@berkeley.cs.edu
14
15<< 12 May 1983 >>
16To install this directory on your system:
17
18First determine a list of "common terminals" for your system.
19This list will probably be small, and can be empty if you like,
20but you should probably put your own terminal in it.
21
22Second, edit the editor script "reorder" to use this list instead
23of the list built in to it.  The changes will be evident from looking
24at the script.  Notice that the script contains the terminals in order
25from least common to most common, since the move commands will move them
26to the front in that order, the effect will be to put the most common
27at the front of termcap since that's moved last.  The s.* terminals
28are specials, and although they don't have to go to the front, they are
29probably quite common and really should go near the front.
30
31Third, if you are not a super user and cannot create the directory
32/usr/lib/tabset, make a corresponding directory somewhere you can and
33add a line to reorder to globally change all /usr/lib/tabset's to your
34own path name.  This change is better than just changing the termcap.src
35file because it makes it easier to diff it from newer distributed versions.
36Try to keep the source as is whenever possible, and put mungings into reorder.
37
38Now you can run "make install" which will create an /etc/termcap. Again,
39if you aren't a super user change the cp command to put it where you can.
40In this case you will have to redefine E_TERMCAP in "local/uparm.h", which
41will probably be in subdirectories with the other UCB software.
42
43
44Finally, if you make additions or fixes to termcap, please mail a note
45explaining what you did with the fixed termcap entry (not the whole file,
46please!) to me at one of the addresses below, so it can be incorporated
47back into the original source.  I will normally include anything unless
48there is a good reason not to, but I reserve the right to redo it differently.
49
50	uunet!ucbvax!termcap			(uucp)
51	termcap@berkeley.cs.edu			(Internet)
52