]> ncurses.scripts.mit.edu Git - ncurses.git/blob - man/infotocap.1m
ncurses 6.4 - patch 20231007
[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.34 2023/10/07 21:19:07 tom Exp $
31 .TH @INFOTOCAP@ 1M 2023-10-07 "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 n 5
44 .ds d @TERMINFO@
45 .SH NAME
46 \fB\%@INFOTOCAP@\fP \-
47 convert a \fIterminfo\fR description into a \fItermcap\fR 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 looks in each given text
57 \fIfile\fP for \fIterminfo\fP descriptions.
58 For each one found,
59 it writes an analogous \fItermcap\fP description to the standard output
60 stream.
61 \fIterminfo\fP \*(``\fBuse\fP\*('' capabilities are translated directly
62 to \fItermcap\fP \fBtc\fP capabilities.
63 Because \fItermcap\fP is a less expressive format than \fIterminfo\fP,
64 some capabilities cannot be translated.
65 .PP
66 This utility is implemented as a link to \fB\%@TIC@\fP(1M),
67 with the latter's
68 .B \-C
69 option implied.
70 You can use other \fB\%@TIC@\fP options such as
71 .BR \-1 ,
72 .BR \-f ,
73 .BR \-v ,
74 .BR \-w ,
75 and
76 .BR \-x .
77 The \fB\-V\fP option reports the version of \fIncurses\fP associated
78 with this program and exits with a successful status.
79 .SH FILES
80 .TP
81 \fI\*d\fP
82 compiled terminal description database
83 .SH PORTABILITY
84 None of X/Open Curses, Issue 7 (2009),
85 SVr4,
86 or NetBSD document this application.
87 .SH AUTHOR
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(\*n)