]> ncurses.scripts.mit.edu Git - ncurses.git/blob - man/infotocap.1m
ncurses 6.4 - patch 20231125
[ncurses.git] / man / infotocap.1m
1 .\"***************************************************************************
2 .\" Copyright 2018-2022,2023 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.37 2023/11/25 14:32:36 tom Exp $
31 .TH @INFOTOCAP@ 1M 2023-11-25 "ncurses 6.4" "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 .ds d @TERMINFO@
44 .SH NAME
45 \fB\%@INFOTOCAP@\fP \-
46 convert a \fI\%terminfo\fR description into a \fI\%termcap\fR
47 description
48 .SH SYNOPSIS
49 .B @INFOTOCAP@
50 .RI [ tic-option ]
51 .I file
52 \&.\|.\|.
53 .P
54 .B "@INFOTOCAP@ \-V"
55 .SH DESCRIPTION
56 \fB\%@INFOTOCAP@\fP translates terminal descriptions.
57 It looks in each given text \fIfile\fP for \fI\%terminfo\fP entries and,
58 For each one found,
59 it writes an analogous \fI\%termcap\fP description to the standard
60 output stream.
61 \fI\%terminfo\fP \*(``\fBuse\fP\*('' capabilities translate to
62 \fI\%termcap\fP \fBtc\fP capabilities.
63 Because \fI\%termcap\fP is a less expressive format than
64 \fI\%terminfo\fP,
65 some capabilities cannot be translated.
66 .PP
67 This utility is implemented as a link to \fB\%@TIC@\fP(1M),
68 with the latter's
69 .B \-C
70 option implied.
71 You can use other \fB\%@TIC@\fP options such as
72 .BR \-1 ,
73 .BR \-f ,
74 .BR \-v ,
75 .BR \-w ,
76 and
77 .BR \-x .
78 The \fB\-V\fP option reports the version of \fI\%ncurses\fP associated
79 with this program and exits with a successful status.
80 .SH FILES
81 .TP
82 .I \*d
83 compiled terminal description database
84 .SH PORTABILITY
85 None of X/Open Curses,
86 Issue 7 (2009),
87 SVr4,
88 or NetBSD document this application.
89 .SH AUTHORS
90 Eric S. Raymond <esr@snark.thyrsus.com>
91 and
92 .br
93 Thomas E. Dickey <dickey@invisible\-island.net>
94 .SH SEE ALSO
95 \fB\%@INFOCMP@\fP(1M),
96 \fB\%@TIC@\fP(1M),
97 \fB\%curses\fP(3X),
98 \fB\%terminfo\fP(5)