# toe 1m

    toe(1m)                                                                toe(1m)

## NAME

           toe - table of (terminfo) entries

## SYNOPSIS

           toe [-v[n]] [-ahsuUV] file...

## DESCRIPTION

           With no options, toe 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 -h option,  a  directory
           header will be issued as each directory is entered.

           There are other options intended for use by terminfo file maintainers:

           -a     report  on  all  of  the  terminal databases which ncurses would
                  search, rather than only the first one that it finds.

                  If the -s is also given,  toe  adds  a  column  to  the  report,
                  showing (like conflict(1)) which entries which belong to a given
                  terminal database.  An "*" marks entries which differ,  and  "+"
                  marks equivalent entries.

                  Without  the -s option, toe does not attempt to merge duplicates
                  in its report

           -s     sort the output by the entry names.

           -u file
                  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

           -U file
                  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.

           -vn    specifies that (verbose) output be written  to  standard  error,
                  showing toe's progress.

                  The  optional  parameter n is a number from 1 to 10, interpreted
                  as for tic(1m).  If ncurses is built  without  tracing  support,
                  the optional parameter is ignored.

           -V     reports  the  version of ncurses which was used in this program,
                  and exits.

## EXAMPLES

           Without sorting, the -a option reports all of the names found in all of
           the   terminal  databases  found  by  the  TERMINFO  and  TERMINFO_DIRS
           environment variables:

               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
               . . .

           Use the -a  and  -s  options  together  to  show  where  each  terminal
           description was found:

               --> /usr/local/ncurses/share/terminfo
               ----> /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
               . . .

## FILES

           /usr/share/terminfo/?/*
                Compiled terminal description database.

## HISTORY

           This  utility  is  not  provided by other implementations.  There is no
           relevant X/Open or POSIX standard for toe.

           The program name refers to a developer's pun:

           o   tic,

           o   tac (now tack),

           o   toe.

           It replaced a -T option which was  briefly  supported  by  the  ncurses
           infocmp utility in 1995.

           The  -a  and -s options were added to toe several years later (2006 and
           2011, respectively).

## SEE ALSO

           captoinfo(1m),   infocmp(1m),   infotocap(1m),   tic(1m),   curses(3x),
           terminfo(5).

           This describes ncurses version 6.3 (patch 20221029).

                                                                           toe(1m)