Manual Page Result
0
Command: toe | Section: 1 | Source: FreeBSD | File: toe.1.gz
toe(1M) User commands toe(1M)
NAME
toe - list table of entries of terminfo terminal types
SYNOPSIS
toe [-ahs] [-v [n]] [directory ...]
toe [-u|-U] file
toe -V
DESCRIPTION
toe reports to the standard output stream the (primary) names and de-
scriptions of the terminal types available to the terminfo library.
Each directory is scanned; if none are given, toe scans the default
terminfo directory.
OPTIONS
The -h option can be helpful to observe where toe is looking for termi-
nal descriptions. Other options support maintainers of terminfo termi-
nal descriptions.
-a lists entries from all terminal database directories that ter-
minfo would search, instead of only the first that it finds.
If -s is also given, toe additionally reports, like
conflict(1), which entries correspond to a given terminal
database. An "*" marks entries that differ, and "+" marks
equivalent entries.
Without the -s option, toe does not attempt to merge dupli-
cates in its report.
-h writes a heading naming each each directory as it is accessed.
-s sorts the output by the entry names.
-u file lists terminal type dependencies in file, a terminfo entry
source or termcap database file. The report summarizes the
"use" (terminfo) and tc (termcap) relations: each line com-
prises the primary name of a terminal type employing use/tc
capabilities, a colon, a space- and tab-separated list of pri-
mary names of terminal types thus named, and a newline.
-U file lists terminal type reverse dependencies in file, a terminfo
entry source or termcap database file. The report summarizes
the "use" (terminfo) and tc (termcap) reverse relations: each
line comprises the primary name of a terminal type occurring
in use/tc capabilities, a colon, a space- and tab-separated
list of primary names of terminal types naming them thus, and
a newline.
-v [n] reports verbose status information to the standard error
stream, showing toe's progress.
The optional parameter n is an integer between 1 and 10 inclu-
sive, interpreted as for tic(1M). If ncurses is built without
tracing support, n is ignored.
-V reports the version of ncurses associated with this program
and exits with a successful status.
FILES
/usr/share/misc/terminfo
compiled terminal description database
PORTABILITY
toe is not provided by other implementations. There is no applicable
X/Open or POSIX standard for it.
HISTORY
toe replaces a -T option that was briefly supported by the ncurses
infocmp utility in 1995.
The -a and -s options were added in 2006 and 2011, respectively.
The program's name originates with a developer's pun:
o tic,
o tac (now tack),
o toe.
EXAMPLES
When not sorting with the -s option, the -a option reports all of the
names found in all of the terminal database directories named in the
TERMINFO and TERMINFO_DIRS environment variables.
L2 Lx. xterm-color generic color xterm xterm-xfree86 xterm
terminal emulator (XFree86) xterm-vt220 xterm emulating vt220
xterm-256color xterm with 256 colors xterm-r6 xterm X11R6 version
xterm-r5 xterm R5 version xterm-mono monochrome xterm
xterm T{ xterm terminal emulator (X Window System) T}
vt220 dec vt220 vt102 dec vt102 vt100 dec vt100 (w/ad-
vanced video) vt52 dec vt52 L. ...
Use the -a and -s options together to show where each terminal descrip-
tion was found.
Lx. --> /etc/terminfo ----> /lib/terminfo ------> /usr/share/ter-
minfo L1 L2 Lx. --*---: vt100 dec vt100 (w/advanced video)
--*---: vt102 dec vt102 --*---: vt220 dec vt220
--*---: vt52 dec vt52 --*---: xterm T{ xterm terminal emu-
lator (X Window System) T} --*---: xterm-256color xterm with 256
colors --*---: xterm-color generic color xterm
--*---: xterm-mono monochrome xterm --*---: xterm-r5 xterm
R5 version --*---: xterm-r6 xterm X11R6 version
--*---: xterm-vt220 xterm emulating vt220
--*---: xterm-xfree86 T{ xterm terminal emulator (XFree86) T} L.
...
SEE ALSO
captoinfo(1M), infocmp(1M), infotocap(1M), tic(1M), curses(3X),
terminfo(5)
ncurses 6.5 2024-04-20 toe(1M)