.\"***************************************************************************
-.\" Copyright 2019,2020 Thomas E. Dickey *
+.\" Copyright 2019-2022,2023 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.32 2020/02/02 23:34:34 tom Exp $
-.TH @TOE@ 1M ""
+.\" $Id: toe.1m,v 1.40 2023/07/01 15:46:10 tom Exp $
+.TH @TOE@ 1M 2023-07-01 "ncurses 6.4" "User commands"
.de bP
.ie n .IP \(bu 4
.el .IP \(bu 2
.ie n .in +4
.el .in +2
.nf
-.ft C \" Courier
+.ft CR \" Courier
..
.de NE
.fi
.ds n 5
.ds d @TERMINFO@
.SH NAME
-\fB@TOE@\fR \- table of (terminfo) entries
+\fB@TOE@\fP \- table of (terminfo) entries
.SH SYNOPSIS
-\fB@TOE@\fR [\fB\-v\fR[\fIn\fR]] [\fB\-ahsuUV\fR] \fIfile...\fR
-.br
+\fB@TOE@\fP [\fB\-v\fP[\fIn\fP]] [\fB\-ahsuUV\fP] \fIfile...\fP
.SH DESCRIPTION
-.PP
With no options,
-\fB@TOE@\fR lists all available terminal types by primary name
+\fB@TOE@\fP 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 \fB\-h\fR option,
+If you also specify the \fB\-h\fP option,
a directory header will be issued as each
directory is entered.
.PP
There are other options intended for use by terminfo file maintainers:
.TP
-\fB\-a\fR
+\fB\-a\fP
report on all of the terminal databases which ncurses would search,
rather than only the first one that it finds.
.IP
-If the \fB\-s\fR is also given, \fB@TOE@\fR
+If the \fB\-s\fP is also given, \fB@TOE@\fP
adds a column to the report,
-showing (like \fBconflict\fP(1)) which entries which
+showing (like \fBconflict\fP(1)) which entries which
belong to a given terminal database.
An "*" marks entries which differ, and "+" marks equivalent entries.
.IP
-Without the \fB\-s\fP option, \fB@TOE@\fR does not attempt to merge
+Without the \fB\-s\fP option, \fB@TOE@\fP does not attempt to merge
duplicates in its report
.TP
-\fB\-s\fR
+\fB\-s\fP
sort the output by the entry names.
.TP
-\fB\-u\fR \fIfile\fR
+\fB\-u\fP \fIfile\fP
says to write a report to the standard output,
listing dependencies in the given terminfo/termcap source file.
The report condenses the \*(``use\*('' relation:
capabilities,
followed by a newline
.TP
-\fB\-U\fR \fIfile\fR
+\fB\-U\fP \fIfile\fP
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:
whitespace-separated primary names of all terminals which depend on it,
followed by a newline.
.TP
-\fB\-v\fR\fIn\fR
+\fB\-v\fIn\fR
specifies that (verbose) output be written to standard error,
-showing \fB@TOE@\fR's progress.
+showing \fB@TOE@\fP's progress.
.IP
-The optional parameter \fIn\fR is a number from 1 to 10,
-interpreted as for \fB@TIC@\fR(1M).
+The optional parameter \fIn\fP is a number from 1 to 10,
+interpreted as for \fB@TIC@\fP(1M).
If ncurses is built without tracing support, the optional parameter is ignored.
.TP
-\fB\-V\fR
+\fB\-V\fP
reports the version of ncurses which was used in this program,
and exits.
.SH EXAMPLES
-.PP
Without sorting, the \fB\-a\fP option reports all of the names found
in all of the terminal databases found by the \fBTERMINFO\fP and
\fBTERMINFO_DIRS\fP environment variables:
.NE
.SH FILES
.TP 5
-\fB\*d/?/*\fR
+\fB\*d/?/*\fP
Compiled terminal description database.
.SH HISTORY
This utility is not provided by other implementations.
There is no relevant X/Open or POSIX standard for \fB@TOE@\fP.
-.PP
+.PP
The program name refers to a developer's pun:
.bP
\fBtic\fP,
It replaced a \fB\-T\fP option which was briefly supported by
the ncurses \fBinfocmp\fP utility in 1995.
.PP
-The \fB\-a\fP and \fB\-s\fP options were added to
-\fB@TOE@\fR several years later (2006 and 2011, respectively).
+The \fB\-a\fP and \fB\-s\fP options were added to
+\fB@TOE@\fP several years later (2006 and 2011, respectively).
.SH SEE ALSO
-\fB@TIC@\fR(1M),
-\fB@INFOCMP@\fR(1M),
-\fB@CAPTOINFO@\fR(1M),
-\fB@INFOTOCAP@\fR(1M),
-\fBcurses\fR(3X),
-\fBterminfo\fR(\*n).
+\fB@CAPTOINFO@\fP(1M),
+\fB@INFOCMP@\fP(1M),
+\fB@INFOTOCAP@\fP(1M),
+\fB@TIC@\fP(1M),
+\fBcurses\fP(3X),
+\fBterminfo\fP(\*n).
.PP
-This describes \fBncurses\fR
+This describes \fBncurses\fP
version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).