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