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