freebsd-nq/share/termcap/README
Enji Cooper 1db9ecff02 Remove termcap entry reordering; install the file verbatim instead
termcap entry reordering requires ex (which is available via usr.bin/vi), which
breaks on build hosts where installworld is run with MK_VI == no (or when
make delete-old is run on ^/projects/building-blocks as vi, et al, are
removed on the branch when the knob is tweaked to => "no")

Reordering termcap was believed to improve performance, but the file is now
accessed via /etc/termcap.db, so /etc/termcap (and /usr/share/misc/termcap by
proxy) access is less preferred.

Reordering the file broke the historical comment <-> entry mapping as well,
which could muddle the purpose of entries in the file, so it could be
potentially harmful to readers in its reordered state.

Discussion took place on hackers@ here:
https://lists.freebsd.org/pipermail/freebsd-hackers/2014-December/046657.html

Discussed with: -hackers, mp
MFC after: 1 month
Sponsored by: EMC / Isilon Storage Division
2014-12-10 20:40:03 +00:00

58 lines
2.5 KiB
Plaintext

# @(#)README 8.1 (Berkeley) 6/8/93
#
# $FreeBSD$
<< 12 May 1983 >>
To install this directory on your system:
First determine a list of "common terminals" for your system. This list
will probably be small, and can be empty if you like, but you should
probably put your own terminal in it.
Second, edit the editor script "reorder" to use this list instead of the
list built in to it. The changes will be evident from looking at the
script. Notice that the script contains the terminals in order from least
common to most common, since the move commands will move them to the front
in that order, the effect will be to put the most common at the front of
termcap since that's moved last. The s.* terminals are specials, and
although they don't have to go to the front, they are probably quite
common and really should go near the front.
Third, if you are not a super user and cannot create the directory
/usr/lib/tabset, make a corresponding directory somewhere you can and add
a line to reorder to globally change all /usr/lib/tabset's to your own
path name. This change is better than just changing the termcap file
because it makes it easier to diff it from newer distributed versions.
Try to keep the source as is whenever possible, and put mungings into
reorder.
Now you can run "make install" which will create an /etc/termcap. Again,
if you aren't a super user change the cp command to put it where you can.
In this case you will have to redefine E_TERMCAP in "local/uparm.h", which
will probably be in subdirectories with the other UCB software.
Finally, if you make additions or fixes to termcap, please mail a note
explaining what you did with the fixed termcap entry (not the whole file,
please!) to me at one of the addresses below, so it can be incorporated
back into the original source. I will normally include anything unless
there is a good reason not to, but I reserve the right to redo it differently.
uunet!ucbvax!termcap (uucp)
termcap@berkeley.cs.edu (Internet)
<< 14 October 1987 >>
It is probably easiest to make local termcap changes in separate
files, eg /usr/local/etc/termcap, and encourage people to put
setenv TERMPATH ~/.termcap:/usr/local/etc/termcap:/etc/termcap
in their shell startup files. This way local system-wide changes can be
isolated in /usr/local/etc/termcap and user changes in ~/.termcap, all
without consuming lots of disk or requiring re-integration of local
changes when system termcap files change.
John Kunze
termcap@berkeley.cs.edu