X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Ftoe.1m;h=26383553f8b6704608e4b355e3a558a51b926c28;hb=bd2d9c5734d2c66abe0b2ddd766695b200c154fe;hp=251382eb8cf1b244a7e79252e776d31b9e0ee994;hpb=2de8c14bb2c6f8e61cfbbfb1f0f30d1ad64c8d68;p=ncurses.git diff --git a/man/toe.1m b/man/toe.1m index 251382eb..26383553 100644 --- a/man/toe.1m +++ b/man/toe.1m @@ -1,6 +1,6 @@ '\" 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 * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: toe.1m,v 1.54 2023/10/21 15:30:27 tom Exp $ -.TH @TOE@ 1M 2023-10-21 "ncurses 6.4" "User commands" +.\" $Id: toe.1m,v 1.64 2024/01/20 16:51:21 tom Exp $ +.TH @TOE@ 1M 2024-01-20 "ncurses 6.4" "User commands" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -50,7 +50,6 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. -.ds n 5 .ds d @TERMINFO@ .SH NAME \fB\%@TOE@\fP \- @@ -72,9 +71,9 @@ list table of entries of \fIterminfo\fR terminal types \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. @@ -133,22 +132,44 @@ showing \fB\%@TOE@\fP's progress. .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 @@ -156,8 +177,10 @@ xterm\-256color xterm with 256 colors 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) @@ -166,6 +189,7 @@ vt52 dec vt52 L. \&.\|.\|. .TE +.ft .RE .PP Use the \fB\-a\fP and \fB\-s\fP options together to show where each @@ -173,58 +197,43 @@ terminal description was found. .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 -.I \*d -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)