summaryrefslogtreecommitdiffstats
path: root/man5/termcap.5
diff options
context:
space:
mode:
Diffstat (limited to 'man5/termcap.5')
-rw-r--r--man5/termcap.536
1 files changed, 18 insertions, 18 deletions
diff --git a/man5/termcap.5 b/man5/termcap.5
index 880c957..8aefa68 100644
--- a/man5/termcap.5
+++ b/man5/termcap.5
@@ -9,7 +9,7 @@
.\" If mistakes in the capabilities are found, please send a bug report to:
.\" michael@moria.de
.\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond (esr@thyrsus.com)
-.TH termcap 5 2023-03-08 "Linux man-pages 6.05.01"
+.TH termcap 5 2023-10-31 "Linux man-pages 6.7"
.SH NAME
termcap \- terminal capability database
.SH DESCRIPTION
@@ -19,7 +19,7 @@ It is retained only for compatibility with old programs;
new programs should use the
.BR terminfo (5)
database and associated libraries.
-.PP
+.P
.I /etc/termcap
is an ASCII file (the database master) that lists the capabilities of
many different types of terminals.
@@ -32,18 +32,18 @@ handled by
The termcap database is indexed on the
.B TERM
environment variable.
-.PP
+.P
Termcap entries must be defined on a single logical line, with \[aq]\e\[aq]
used to suppress the newline.
Fields are separated by \[aq]:\[aq].
The first field of each entry starts at the left-hand margin,
and contains a list of names for the terminal, separated by \[aq]|\[aq].
-.PP
+.P
The first subfield may (in BSD termcap entries from 4.3BSD and
earlier) contain a short name consisting of two characters.
This short name may consist of capital or small letters.
In 4.4BSD, termcap entries this field is omitted.
-.PP
+.P
The second subfield (first, in the newer 4.4BSD format) contains the
name used by the environment variable
.BR TERM .
@@ -56,18 +56,18 @@ Usual suffixes are w (more than 80 characters wide), am
display).
The third subfield contains a long and descriptive name for
this termcap entry.
-.PP
+.P
Subsequent fields contain the terminal capabilities; any continued
capability lines must be indented one tab from the left margin.
-.PP
+.P
Although there is no defined order, it is suggested to write first
boolean, then numeric, and then string capabilities, each sorted
alphabetically without looking at lower or upper spelling.
Capabilities of similar functions can be written in one line.
-.PP
+.P
Example for:
.nf
-.PP
+.P
Head line: vt|vt101|DEC VT 101 terminal in 80 character mode:\e
Head line: Vt|vt101-w|DEC VT 101 terminal in (wide) 132 character mode:\e
Boolean: :bs:\e
@@ -358,15 +358,15 @@ vs Standout cursor
wi Set window from line %1 to %2 and column %3 to %4
XF XOFF character if not \fB\[ha]S\fP
.fi
-.PP
+.P
There are several ways of defining the control codes for string capabilities:
-.PP
+.P
Every normal character represents itself,
except \[aq]\[ha]\[aq], \[aq]\e\[aq], and \[aq]%\[aq].
-.PP
+.P
A \fB\[ha]x\fP means Control-x.
Control-A equals 1 decimal.
-.PP
+.P
\ex means a special code.
x can be one of the following characters:
.RS
@@ -403,7 +403,7 @@ Do ASCII output of this parameter with a field with of 3
.TP
%
Print a \[aq]%\[aq]
-.PP
+.P
If you use binary output,
then you should avoid the null character (\[aq]\e0\[aq])
because it terminates the string.
@@ -413,7 +413,7 @@ if a tabulator can be the binary output of a parameter.
Warning:
The above metacharacters for parameters may be wrong: they document Minix
termcap which may not be compatible with Linux termcap.
-.PP
+.P
The block graphic characters can be specified by three string capabilities:
.TP
as
@@ -426,9 +426,9 @@ ac
pairs of characters.
The first character is the name of the block graphic
symbol and the second characters is its definition.
-.PP
+.P
The following names are available:
-.PP
+.P
.nf
+ right arrow (>)
, left arrow (<)
@@ -456,7 +456,7 @@ w normal tee (+)
x vertical line (|)
\[ti] paragraph (???)
.fi
-.PP
+.P
The values in parentheses are suggested defaults which are used by the
.I curses
library, if the capabilities are missing.