man-pages/man1/toe.1.html
2021-03-31 01:06:50 +01:00

230 lines
6.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of toe</TITLE>
</HEAD><BODY>
<H1>toe</H1>
Section: User Commands (1)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
<B>toe</B> - table of (terminfo) entries
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>toe</B> [<B>-v</B>[<I>n</I>]] [<B>-ahsuUV</B>] <I>file...</I>
<BR>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
With no options,
<B>toe</B> lists all available terminal types by primary name
with descriptions.
File arguments specify the directories to be scanned; if no
such arguments are given,
your default terminfo directory is scanned.
If you also specify the <B>-h</B> option,
a directory header will be issued as each
directory is entered.
<P>
There are other options intended for use by terminfo file maintainers:
<DL COMPACT>
<DT id="1"><B>-a</B><DD>
report on all of the terminal databases which ncurses would search,
rather than only the first one that it finds.
<DT id="2"><DD>
If the <B>-s</B> is also given, <B>toe</B>
adds a column to the report,
showing (like <B><A HREF="/cgi-bin/man/man2html?1+conflict">conflict</A></B>(1)) which entries which
belong to a given terminal database.
An &quot;*&quot; marks entries which differ, and &quot;+&quot; marks equivalent entries.
<DT id="3"><DD>
Without the <B>-s</B> option, <B>toe</B> does not attempt to merge
duplicates in its report
<DT id="4"><B>-s</B><DD>
sort the output by the entry names.
<DT id="5"><B>-u</B> <I>file</I><DD>
says to write a report to the standard output,
listing dependencies in the given terminfo/termcap source file.
The report condenses the ``use'' relation:
each line consists of the primary name of a terminal that
has use capabilities,
followed by a colon,
followed by the
whitespace-separated primary names of all terminals which occur in those use
capabilities,
followed by a newline
<DT id="6"><B>-U</B> <I>file</I><DD>
says to write a report to the standard output,
listing reverse dependencies in the given terminfo/termcap source file.
The report reverses the ``use'' relation:
each line consists of the primary name of a
terminal that occurs in use capabilities,
followed by a colon,
followed by the
whitespace-separated primary names of all terminals which depend on it,
followed by a newline.
<DT id="7"><B>-v</B><I>n</I><DD>
specifies that (verbose) output be written to standard error,
showing <B>toe</B>'s progress.
<DT id="8"><DD>
The optional parameter <I>n</I> is a number from 1 to 10,
interpreted as for <B><A HREF="/cgi-bin/man/man2html?1+tic">tic</A></B>(1).
If ncurses is built without tracing support, the optional parameter is ignored.
<DT id="9"><B>-V</B><DD>
reports the version of ncurses which was used in this program,
and exits.
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>EXAMPLES</H2>
<P>
Without sorting, the <B>-a</B> option reports all of the names found
in all of the terminal databases found by the <B>TERMINFO</B> and
<B>TERMINFO_DIRS</B> environment variables:
<BR>&nbsp;.sp
<BR>&nbsp;.in&nbsp;+4
<PRE>
MtxOrb162 16x2 Matrix Orbital LCD display
MtxOrb204 20x4 Matrix Orbital LCD display
MtxOrb Generic Matrix Orbital LCD display
qvt101+ qume qvt 101 PLUS product
qvt119+-25 QVT 119 PLUS with 25 data lines
qansi-g QNX ANSI
qvt103 qume qvt 103
qnxw QNX4 windows
qansi-w QNX ansi for windows
qnxm QNX4 with mouse events
qvt203-25-w QVT 203 PLUS with 25 by 132 columns
qansi-t QNX ansi without console writes
.&nbsp;.&nbsp;.
</PRE>
<BR>&nbsp;.in&nbsp;-4
<P>
Use the <B>-a</B> and <B>-s</B> options together to show where each terminal
description was found:
<BR>&nbsp;.sp
<BR>&nbsp;.in&nbsp;+4
<PRE>
--&gt; /usr/local/ncurses/share/terminfo
----&gt; /usr/share/terminfo
*-+-: 9term Plan9 terminal emulator for X
*---: Eterm Eterm with xterm-style color support (X Window System)
*-*-: Eterm-256color Eterm with xterm 256-colors
*-*-: Eterm-88color Eterm with 88 colors
*-+-: MtxOrb Generic Matrix Orbital LCD display
*-+-: MtxOrb162 16x2 Matrix Orbital LCD display
*-+-: MtxOrb204 20x4 Matrix Orbital LCD display
*-*-: NCR260VT300WPP NCR 2900_260 vt300 wide mode pc+ kybd
*-+-: aaa ann arbor ambassador/30 lines
*-+-: aaa+dec ann arbor ambassador in dec vt100 mode
*-+-: aaa+rv ann arbor ambassador in reverse video
.&nbsp;.&nbsp;.
</PRE>
<BR>&nbsp;.in&nbsp;-4
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="10"><B>/etc/terminfo/?/*</B><DD>
Compiled terminal description database.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>HISTORY</H2>
This utility is not provided by other implementations.
There is no relevant X/Open or POSIX standard for <B>toe</B>.
<P>
The program name refers to a developer's pun:
<BR>&nbsp;.IP&nbsp;&bull;&nbsp;4
<B>tic</B>,
<BR>&nbsp;.IP&nbsp;&bull;&nbsp;4
<B>tac</B> (now <B>tack</B>),
<BR>&nbsp;.IP&nbsp;&bull;&nbsp;4
<B>toe</B>.
<P>
It replaced a <B>-T</B> option which was briefly supported by
the ncurses <B>infocmp</B> utility in 1995.
<P>
The <B>-a</B> and <B>-s</B> options were added to
<B>toe</B> several years later (2006 and 2011, respectively).
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+tic">tic</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+infocmp">infocmp</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+captoinfo">captoinfo</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+infotocap">infotocap</A></B>(1),
<B>ncurses</B>(3NCURSES),
<B><A HREF="/cgi-bin/man/man2html?5+terminfo">terminfo</A></B>(5).
<P>
This describes <B>ncurses</B>
version 6.2 (patch 20200212).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="14"><A HREF="#lbAE">EXAMPLES</A><DD>
<DT id="15"><A HREF="#lbAF">FILES</A><DD>
<DT id="16"><A HREF="#lbAG">HISTORY</A><DD>
<DT id="17"><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:28 GMT, March 31, 2021
</BODY>
</HTML>