]> ncurses.scripts.mit.edu Git - ncurses.git/blob - man/infotocap.1m
ncurses 6.5 - patch 20240615
[ncurses.git] / man / infotocap.1m
1 .\"***************************************************************************
2 .\" Copyright 2018-2023,2024 Thomas E. Dickey                                *
3 .\" Copyright 1999-2010,2016 Free Software Foundation, Inc.                  *
4 .\"                                                                          *
5 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
6 .\" copy of this software and associated documentation files (the            *
7 .\" "Software"), to deal in the Software without restriction, including      *
8 .\" without limitation the rights to use, copy, modify, merge, publish,      *
9 .\" distribute, distribute with modifications, sublicense, and/or sell       *
10 .\" copies of the Software, and to permit persons to whom the Software is    *
11 .\" furnished to do so, subject to the following conditions:                 *
12 .\"                                                                          *
13 .\" The above copyright notice and this permission notice shall be included  *
14 .\" in all copies or substantial portions of the Software.                   *
15 .\"                                                                          *
16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
18 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
19 .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
20 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
21 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
22 .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
23 .\"                                                                          *
24 .\" Except as contained in this notice, the name(s) of the above copyright   *
25 .\" holders shall not be used in advertising or otherwise to promote the     *
26 .\" sale, use or other dealings in this Software without prior written       *
27 .\" authorization.                                                           *
28 .\"***************************************************************************
29 .\"
30 .\" $Id: infotocap.1m,v 1.42 2024/05/11 20:39:53 tom Exp $
31 .TH @INFOTOCAP@ 1M 2024-05-11 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands"
32 .ie \n(.g \{\
33 .ds `` \(lq
34 .ds '' \(rq
35 .\}
36 .el \{\
37 .ie t .ds `` ``
38 .el   .ds `` ""
39 .ie t .ds '' ''
40 .el   .ds '' ""
41 .\}
42 .
43 .SH NAME
44 \fB\%@INFOTOCAP@\fP \-
45 convert a \fI\%terminfo\fR description into a \fI\%termcap\fR description
46 .SH SYNOPSIS
47 .B @INFOTOCAP@
48 .RI [ tic-option ]
49 .I file
50 \&.\|.\|.
51 .P
52 .B "@INFOTOCAP@ \-V"
53 .SH DESCRIPTION
54 \fB\%@INFOTOCAP@\fP translates terminal descriptions.
55 It looks in each given text \fIfile\fP for \fI\%terminfo\fP entries and,
56 For each one found,
57 it writes an analogous \fI\%termcap\fP description to the standard
58 output stream.
59 \fI\%terminfo\fP \*(``\fBuse\fP\*('' capabilities translate to
60 \fI\%termcap\fP \fBtc\fP capabilities.
61 Because \fI\%termcap\fP is a less expressive format than
62 \fI\%terminfo\fP,
63 some capabilities cannot be translated.
64 .PP
65 This utility is implemented as a link to \fB\%@TIC@\fP(1M),
66 with the latter's
67 .B \-C
68 option implied.
69 You can use other \fB\%@TIC@\fP options such as
70 .BR \-1 ,
71 .BR \-f ,
72 .BR \-v ,
73 .BR \-w ,
74 and
75 .BR \-x .
76 The \fB\-V\fP option reports the version of \fI\%ncurses\fP associated
77 with this program and exits with a successful status.
78 .SH FILES
79 .TP
80 .I @TERMINFO@
81 compiled terminal description database
82 .SH PORTABILITY
83 None of X/Open Curses,
84 Issue 7 (2009),
85 SVr4,
86 or NetBSD document this application.
87 .SH AUTHORS
88 Eric S. Raymond <esr@snark.thyrsus.com>
89 and
90 .br
91 Thomas E. Dickey <dickey@invisible\-island.net>
92 .SH SEE ALSO
93 \fB\%@INFOCMP@\fP(1M),
94 \fB\%@TIC@\fP(1M),
95 \fB\%curses\fP(3X),
96 \fB\%terminfo\fP(5)