aboutsummaryrefslogtreecommitdiff
path: root/lib/libncurses/term.5
diff options
context:
space:
mode:
authorPeter Wemm <peter@FreeBSD.org>1999-08-30 07:58:08 +0000
committerPeter Wemm <peter@FreeBSD.org>1999-08-30 07:58:08 +0000
commit99af2e21c73f07587da16d34eb6795f4a46cc5be (patch)
tree5df591f7e443330146099aa76e2f474a81669ebf /lib/libncurses/term.5
parent02e1576966f0a3b9300a7269c3e6894e62b1f3ba (diff)
Use src/contrib/ncurses, v5.0.990821 prerelease.
This isn't quite finished yet, there are still some unresolved problems with ospeed and the sgtty.h (non-posix) terminal interface. Mostly this only causes problems with src/games. The other tools and libraries (libform,libpanel,libmenu) will come shortly but are seperate. Beware, there be dragons here! (The build will be broken for a short while)
Notes
Notes: svn path=/head/; revision=50624
Diffstat (limited to 'lib/libncurses/term.5')
-rw-r--r--lib/libncurses/term.5155
1 files changed, 0 insertions, 155 deletions
diff --git a/lib/libncurses/term.5 b/lib/libncurses/term.5
deleted file mode 100644
index 1dc0a32bd5fb..000000000000
--- a/lib/libncurses/term.5
+++ /dev/null
@@ -1,155 +0,0 @@
-.\" $FreeBSD$
-.\"
-.TH TERM 5
-.ds n 5
-.ds d /usr/lib/terminfo
-.SH NAME
-term \- format of compiled term file.
-.SH SYNOPSIS
-.B term
-.SH DESCRIPTION
-.PP
-Compiled terminfo descriptions are placed under the directory \fB\*d\fP.
-In order to avoid a linear search of a huge \s-1UNIX\s+1 system directory, a
-two-level scheme is used: \fB\*b/c/name\fP
-where
-.I name
-is the name of the terminal, and
-.I c
-is the first character of
-.IR name .
-Thus,
-.I act4
-can be found in the file \fB\*d/a/act4\fP.
-Synonyms for the same terminal are implemented by multiple
-links to the same compiled file.
-.PP
-The format has been chosen so that it will be the same on all hardware.
-An 8 or more bit byte is assumed, but no assumptions about byte ordering
-or sign extension are made.
-.PP
-The compiled file is created with the
-.I tic
-program, and read by the routine
-.IR setupterm .
-Both of these pieces of software are part of
-.IR ncurses (3).
-The file is divided into six parts:
-the header,
-terminal names,
-boolean flags,
-numbers,
-strings,
-and
-string table.
-.PP
-The header section begins the file.
-This section contains six short integers in the format
-described below.
-These integers are
-(1) the magic number (octal 0432);
-(2) the size, in bytes, of the names section;
-(3) the number of bytes in the boolean section;
-(4) the number of short integers in the numbers section;
-(5) the number of offsets (short integers) in the strings section;
-(6) the size, in bytes, of the string table.
-.PP
-Short integers are stored in two 8-bit bytes.
-The first byte contains the least significant 8 bits of the value,
-and the second byte contains the most significant 8 bits.
-(Thus, the value represented is 256*second+first.)
-The value \-1 is represented by 0377, 0377, other negative
-value are illegal.
-The
-\-1 generally means that a capability is missing from this terminal.
-Note that this format corresponds to the hardware of the \s-1VAX\s+1 and \s-1PDP\s+1-11.
-Machines where this does not correspond to the hardware read the
-integers as two bytes and compute the result.
-.PP
-The terminal names section comes next.
-It contains the first line of the terminfo description,
-listing the various names for the terminal,
-separated by the `|' character.
-The section is terminated with an \s-1ASCII NUL\s+1 character.
-.PP
-The boolean flags have one byte for each flag.
-This byte is either 0 or 1 as the flag is present or absent.
-The capabilities are in the same order as the file <term.h>.
-.PP
-Between the boolean section and the number section,
-a null byte will be inserted, if necessary,
-to ensure that the number section begins on an even byte.
-All short integers are aligned on a short word boundary.
-.PP
-The numbers section is similar to the flags section.
-Each capability takes up two bytes,
-and is stored as a short integer.
-If the value represented is \-1, the capability is taken to be missing.
-.PP
-The strings section is also similar.
-Each capability is stored as a short integer, in the format above.
-A value of \-1 means the capability is missing.
-Otherwise, the value is taken as an offset from the beginning
-of the string table.
-Special characters in ^X or \ec notation are stored in their
-interpreted form, not the printing representation.
-Padding information $<nn> and parameter information %x are
-stored intact in uninterpreted form.
-.PP
-The final section is the string table.
-It contains all the values of string capabilities referenced in
-the string section.
-Each string is null terminated.
-.PP
-Note that it is possible for
-.I setupterm
-to expect a different set of capabilities
-than are actually present in the file.
-Either the database may have been updated since
-.I setupterm
-has been recompiled
-(resulting in extra unrecognized entries in the file)
-or the program may have been recompiled more recently
-than the database was updated
-(resulting in missing entries).
-The routine
-.I setupterm
-must be prepared for both possibilities \-
-this is why the numbers and sizes are included.
-Also, new capabilities must always be added at the end of the lists
-of boolean, number, and string capabilities.
-.PP
-As an example, an octal dump of the description for the Microterm ACT 4
-is included:
-.nf
-.sp
-microterm|act4|microterm act iv,
- cr=^M, cud1=^J, ind=^J, bel=^G, am, cub1=^H,
- ed=^_, el=^^, clear=^L, cup=^T%p1%c%p2%c,
- cols#80, lines#24, cuf1=^X, cuu1=^Z, home=^],
-.sp
-.ft CW
-\s-2000 032 001 \e0 025 \e0 \eb \e0 212 \e0 " \e0 m i c r
-020 o t e r m | a c t 4 | m i c r o
-040 t e r m a c t i v \e0 \e0 001 \e0 \e0
-060 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0 \e0
-100 \e0 \e0 P \e0 377 377 030 \e0 377 377 377 377 377 377 377 377
-120 377 377 377 377 \e0 \e0 002 \e0 377 377 377 377 004 \e0 006 \e0
-140 \eb \e0 377 377 377 377 \en \e0 026 \e0 030 \e0 377 377 032 \e0
-160 377 377 377 377 034 \e0 377 377 036 \e0 377 377 377 377 377 377
-200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377
-*
-520 377 377 377 377 \e0 377 377 377 377 377 377 377 377 377 377
-540 377 377 377 377 377 377 007 \e0 \er \e0 \ef \e0 036 \e0 037 \e0
-560 024 % p 1 % c % p 2 % c \e0 \en \e0 035 \e0
-600 \eb \e0 030 \e0 032 \e0 \en \e0\s+2
-.ft R
-.fi
-.sp
-.PP
-Some limitations: total compiled entries cannot exceed 4096 bytes.
-The name field cannot exceed 128 bytes.
-.SH FILES
-\*d/*/* compiled terminal capability data base
-.SH "SEE ALSO"
-ncurses(3), terminfo(5).