+'\" t
.\"***************************************************************************
-.\" Copyright 2019-2022,2023 Thomas E. Dickey *
+.\" Copyright 2019-2023,2024 Thomas E. Dickey *
.\" Copyright 1998-2015,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: toe.1m,v 1.52 2023/10/07 21:19:07 tom Exp $
-.TH @TOE@ 1M 2023-10-07 "ncurses 6.4" "User commands"
+.\" $Id: toe.1m,v 1.68 2024/04/20 18:59:26 tom Exp $
+.TH @TOE@ 1M 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands"
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
.ie n .IP \(bu 4
.el .IP \(bu 2
..
-.ds n 5
.ds d @TERMINFO@
.SH NAME
\fB\%@TOE@\fP \-
\fB\%@TOE@\fP reports to the standard output stream the (primary) names
and descriptions of the terminal types available to the \fIterminfo\fP
library.
-Each \fIdirectory\fP operand is scanned;
+Each \fIdirectory\fP is scanned;
if none are given,
-\fB\%@TOE@\fP scans the the default \fIterminfo\fP directory.
+\fB\%@TOE@\fP scans the default \fIterminfo\fP directory.
.SH OPTIONS
The \fB\-h\fP option can be helpful to observe where \fB\%@TOE@\fP is
looking for terminal descriptions.
would search,
instead of only the first that it finds.
.IP
-If the \fB\-s\fP option is also given,
-\fB\%@TOE@\fP adds a column to the report,
-showing (like \fB\%conflict\fP(1)) which entries belong to a given
-terminal database.
+If
+.B \-s
+is also given,
+\fB\%@TOE@\fP
+additionally reports,
+like \fI\%conflict\fP(1),
+which entries correspond to a given terminal database.
An \*(``*\*('' marks entries that differ,
and \*(``+\*('' marks equivalent entries.
.IP
lists terminal type dependencies in \fIfile\fP,
a \fIterminfo\fP entry source or \fItermcap\fP database file.
The report summarizes the \*(``\fBuse\fP\*('' (\fIterminfo\fP) and
-\*(``\fBtc\fP\*('' (\fItermcap\fP) relations:
+\fBtc\fP (\fItermcap\fP) relations:
each line comprises the primary name of a terminal type employing
\fBuse\fP/\fBtc\fP capabilities,
a colon,
lists terminal type reverse dependencies in \fIfile\fP,
a \fIterminfo\fP entry source or \fItermcap\fP database file.
The report summarizes the \*(``\fBuse\fP\*('' (\fIterminfo\fP) and
-\*(``\fBtc\fP\*('' (\fItermcap\fP) reverse relations:
+\fBtc\fP (\fItermcap\fP) reverse relations:
each line comprises the primary name of a terminal type occurring in
\fBuse\fP/\fBtc\fP capabilities,
a colon,
.IP
The optional parameter \fIn\fP is an integer between 1 and 10 inclusive,
interpreted as for \fB\%@TIC@\fP(1M).
-If \fIncurses\fP is built without tracing support,
+If \fI\%ncurses\fP is built without tracing support,
\fIn\fP is ignored.
.TP
\fB\-V\fP
-reports the version of \fIncurses\fP associated
+reports the version of \fI\%ncurses\fP associated
with this program and exits with a successful status.
+.SH FILES
+.TP
+.I \*d
+compiled terminal description database
+.SH PORTABILITY
+\fB\%@TOE@\fP is not provided by other implementations.
+There is no applicable X/Open or POSIX standard for it.
+.SH HISTORY
+\fB\%@TOE@\fP replaces a \fB\-T\fP option that was briefly supported by
+the \fI\%ncurses\fP \fB\%infocmp\fP utility in 1995.
+.PP
+The \fB\-a\fP and \fB\-s\fP options were added in 2006 and 2011,
+respectively.
+.PP
+The program's name originates with a developer's pun:
+.bP
+\fBtic\fP,
+.bP
+\fBtac\fP (now \fBtack\fP),
+.bP
+\fBtoe\fP.
.SH EXAMPLES
When not sorting with the \fB\-s\fP option,
the \fB\-a\fP option reports all of the names found in all of the
-terminal database directories named in the \fB\%TERMINFO\fP and
-\fB\%TERMINFO_DIRS\fP environment variables.
+terminal database directories named in the \fI\%TERMINFO\fP and
+\fI\%TERMINFO_DIRS\fP environment variables.
.RS 4
.PP
.\" toe -a | grep -E '^(xterm|vt)'
+.ft \*(CW
.TS
-Lf(\*(CW)2 Lf(\*(CW).
+L2 Lx.
xterm\-color generic color xterm
xterm\-xfree86 xterm terminal emulator (XFree86)
xterm\-vt220 xterm emulating vt220
xterm\-r6 xterm X11R6 version
xterm\-r5 xterm R5 version
xterm\-mono monochrome xterm
-.\" The next row overruns the line length on DWB nroff (65n).
-xterm xterm terminal emulator (X Window System)
+xterm T{
+.ad l
+xterm terminal emulator (X Window System)
+T}
vt220 dec vt220
vt102 dec vt102
vt100 dec vt100 (w/advanced video)
L.
\&.\|.\|.
.TE
+.ft
.RE
.PP
Use the \fB\-a\fP and \fB\-s\fP options together to show where each
.RS 4
.PP
.\" toe -as | grep -E '(^-+>|:.(xterm|vt))'
+.ft \*(CW
.TS
-lf(\*(CW).
+Lx.
\-\-> /etc/terminfo
\-\-\-\-> /lib/terminfo
\-\-\-\-\-\-> /usr/share/terminfo
.TE
.TS
-lf(\*(CW)1 lf(\*(CW)2 lf(\*(CW).
+L1 L2 Lx.
\-\-*\-\-\-: vt100 dec vt100 (w/advanced video)
\-\-*\-\-\-: vt102 dec vt102
\-\-*\-\-\-: vt220 dec vt220
\-\-*\-\-\-: vt52 dec vt52
-.\" The next row overruns the line length on DWB nroff (65n).
-\-\-*\-\-\-: xterm xterm terminal emulator (X Window System)
+\-\-*\-\-\-: xterm T{
+.ad l
+xterm terminal emulator (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
-.\" The next row overruns the line length on DWB nroff (65n).
-\-\-*\-\-\-: xterm\-xfree86 xterm terminal emulator (XFree86)
+\-\-*\-\-\-: xterm\-xfree86 T{
+.ad l
+xterm terminal emulator (XFree86)
+T}
.T&
-l.
+L.
\&.\|.\|.
.TE
+.ft
.RE
-.SH FILES
-.TP
-\fI\*d\fP
-compiled terminal description database
-.SH HISTORY
-\fB\%@TOE@\fP is not provided by other implementations.
-There is no applicable X/Open or POSIX standard for it.
-.PP
-It replaces a \fB\-T\fP option that was briefly supported by
-the \fIncurses\fP \fB\%infocmp\fP utility in 1995.
-.PP
-The \fB\-a\fP and \fB\-s\fP options were added in 2006 and 2011,
-respectively.
-.PP
-The program's name originates with a developer's pun:
-.bP
-\fBtic\fP,
-.bP
-\fBtac\fP (now \fBtack\fP),
-.bP
-\fBtoe\fP.
.SH SEE ALSO
\fB\%@CAPTOINFO@\fP(1M),
\fB\%@INFOCMP@\fP(1M),
\fB\%@INFOTOCAP@\fP(1M),
\fB\%@TIC@\fP(1M),
\fB\%curses\fP(3X),
-\fB\%terminfo\fP(\*n)
+\fB\%terminfo\fP(5)
projects / ncurses.git / blobdiff