- With no options, <STRONG>toe</STRONG> 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 <STRONG>-h</STRONG> option, a directory header will be
- issued as each directory is entered.
-
- There are other options intended for use by terminfo file
- maintainers:
-
- <STRONG>-a</STRONG> report on all of the terminal databases which
- ncurses would search, rather than only the first
- one that it finds.
-
- If the <STRONG>-s</STRONG> is also given, <STRONG>toe</STRONG> adds a column to the
- report, showing (like <STRONG>conflict(1)</STRONG>) which entries
- which belong to a given terminal database. An "*"
- marks entries which differ, and "+" marks equiva-
- lent entries.
-
- Without the <STRONG>-s</STRONG> option, <STRONG>toe</STRONG> does not attempt to
- merge duplicates in its report
-
- <STRONG>-s</STRONG> sort the output by the entry names.
-
- <STRONG>-u</STRONG> <EM>file</EM>
- says to write a report to the standard output,
- listing dependencies in the given terminfo/termcap
- source file. The report condenses the `use' rela-
- tion: 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
-
- <STRONG>-U</STRONG> <EM>file</EM>
- says to write a report to the standard output,
- listing reverse dependencies in the given ter-
- minfo/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.
-
- <STRONG>-v</STRONG><EM>n</EM> specifies that (verbose) output be written to stan-
- dard error, showing <STRONG>toe</STRONG>'s progress. The optional
- parameter <EM>n</EM> is a number from 1 to 10, interpreted
- as for <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>.
-
- <STRONG>-V</STRONG> reports the version of ncurses which was used in
- this program, and exits.
+ <STRONG>toe</STRONG> reports to the standard output stream the (primary) names and
+ descriptions of the terminal types available to the <EM>terminfo</EM> library.
+ Each <EM>directory</EM> is scanned; if none are given, <STRONG>toe</STRONG> scans the default
+ <EM>terminfo</EM> directory.
+
+
+</PRE><H2><a name="h2-OPTIONS">OPTIONS</a></H2><PRE>
+ The <STRONG>-h</STRONG> option can be helpful to observe where <STRONG>toe</STRONG> is looking for
+ terminal descriptions. Other options support maintainers of <EM>terminfo</EM>
+ terminal descriptions.
+
+ <STRONG>-a</STRONG> lists entries from all terminal database directories that
+ <EM>terminfo</EM> would search, instead of only the first that it
+ finds.
+
+ If <STRONG>-s</STRONG> is also given, <STRONG>toe</STRONG> additionally reports, like
+ <STRONG>conflict(1)</STRONG>, which entries correspond to a given terminal
+ database. An "*" marks entries that differ, and "+" marks
+ equivalent entries.
+
+ Without the <STRONG>-s</STRONG> option, <STRONG>toe</STRONG> does not attempt to merge
+ duplicates in its report.
+
+ <STRONG>-h</STRONG> writes a heading naming each each directory as it is accessed.
+
+ <STRONG>-s</STRONG> sorts the output by the entry names.
+
+ <STRONG>-u</STRONG> <EM>file</EM> lists terminal type dependencies in <EM>file</EM>, a <EM>terminfo</EM> entry
+ source or <EM>termcap</EM> database file. The report summarizes the
+ "<STRONG>use</STRONG>" (<EM>terminfo</EM>) and <STRONG>tc</STRONG> (<EM>termcap</EM>) relations: each line
+ comprises the primary name of a terminal type employing <STRONG>use</STRONG>/<STRONG>tc</STRONG>
+ capabilities, a colon, a space- and tab-separated list of
+ primary names of terminal types thus named, and a newline.
+
+ <STRONG>-U</STRONG> <EM>file</EM> lists terminal type reverse dependencies in <EM>file</EM>, a <EM>terminfo</EM>
+ entry source or <EM>termcap</EM> database file. The report summarizes
+ the "<STRONG>use</STRONG>" (<EM>terminfo</EM>) and <STRONG>tc</STRONG> (<EM>termcap</EM>) reverse relations: each
+ line comprises the primary name of a terminal type occurring
+ in <STRONG>use</STRONG>/<STRONG>tc</STRONG> capabilities, a colon, a space- and tab-separated
+ list of primary names of terminal types naming them thus, and
+ a newline.
+
+ <STRONG>-v</STRONG> [<EM>n</EM>] reports verbose status information to the standard error
+ stream, showing <STRONG>toe</STRONG>'s progress.
+
+ The optional parameter <EM>n</EM> is an integer between 1 and 10
+ inclusive, interpreted as for <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>. If <EM>ncurses</EM> is built
+ without tracing support, <EM>n</EM> is ignored.
+
+ <STRONG>-V</STRONG> reports the version of <EM>ncurses</EM> associated with this program
+ and exits with a successful status.