ee031f73ac1a7ed9d8151b84bff0cb9599c01b51
[ncurses.git] / man / captoinfo.1m
1 '\" t
2 .TH captoinfo 1M ""
3 .ds n 5
4 .ds d @DATADIR@/terminfo
5 .SH NAME
6 \fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description
7 .SH SYNOPSIS
8 \fBcaptoinfo\fR [\fB-v\fIn\fR \fIwidth\fR]  [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . .
9 .SH DESCRIPTION
10 \fBcaptoinfo\fR looks in \fIfile\fR for \fBtermcap\fR descriptions.  For each
11 one found, an equivalent \fBterminfo\fR description is written to standard
12 output.  Termcap \fBtc\fR capabilities are translated directly to terminfo
13 \fBuse\fR capabilities.
14
15 If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used
16 for the filename or entry.  If \fBTERMCAP\fR is a full pathname to a file, only
17 the terminal whose name is specified in the environment variable \fBTERM\fR is
18 extracted from that file.  If the environment variable \fBTERMCAP\fR is not
19 set, then the file \fB\*d\fR is read.
20 .TP 5
21 \fB-v\fR 
22 print out tracing information on standard error as the program runs.
23 .TP 5
24 \fB-V\fR
25 print out the version of the program in use on standard error and exit.
26 .TP 5
27 \fB-1\fR
28 cause the fields to print out one to a line.  Otherwise, the fields
29 will be printed several to a line to a maximum width of 60
30 characters.
31 .TP 5
32 \fB-w\fR
33 change the output to \fIwidth\fR characters.
34 .SH FILES
35 .TP 20
36 \*d
37 Compiled terminal description database.
38 .SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES
39 .PP
40 Some obsolete nonstandard capabilities will automatically be translated
41 into standard (SVr4/XSI Curses) terminfo capabilities by \fBcaptoinfo\fR.
42 Whenever one of these automatic translations is done, the program
43 will issue an notification to stderr, inviting the user to check that
44 it has not mistakenly translated a completely unknown and random
45 capability and/or syntax error.
46 .PP
47 .TS H
48 c c c c
49 c c c c
50 l l l l.
51 Nonstd  Std     From    Terminfo
52 name    name            capability
53 _
54 BO      mr      AT&T    enter_reverse_mode
55 CI      vi      AT&T    cursor_invisible
56 CV      ve      AT&T    cursor_normal
57 DS      mh      AT&T    enter_dim_mode
58 EE      me      AT&T    exit_attribute_mode     
59 FE      LF      AT&T    label_on
60 FL      LO      AT&T    label_off
61 XS      mk      AT&T    enter_secure_mode
62 EN      @7      XENIX   key_end
63 GE      ae      XENIX   exit_alt_charset_mode
64 GS      as      XENIX   enter_alt_charset_mode
65 HM      kh      XENIX   key_home
66 LD      kL      XENIX   key_dl
67 PD      kN      XENIX   key_npage
68 PN      po      XENIX   prtr_off
69 PS      pf      XENIX   prtr_on
70 PU      kP      XENIX   key_ppage
71 RT      @8      XENIX   kent
72 UP      ku      XENIX   kcuu1
73 KA      k;      Tek     key_f10
74 KB      F1      Tek     key_f11
75 KC      F2      Tek     key_f12
76 KD      F3      Tek     key_f13
77 KE      F4      Tek     key_f14
78 KF      F5      Tek     key_f15
79 BC      Sb      Tek     set_background
80 FC      Sf      Tek     set_foreground
81 HS      mh      Iris    enter_dim_mode
82 .TE
83 .PP
84 XENIX termcap also used to have a set of extension capabilities
85 for forms drawing, designed to take advantage of the IBM PC
86 high-half graphics.  They were as follows:
87 .PP
88 .TS H
89 c c
90 l l.
91 Cap     Graphic
92 _
93 G2      upper left
94 G3      lower left
95 G1      upper right
96 G4      lower right
97 GR      pointing right
98 GL      pointing left
99 GU      pointing up
100 GD      pointing down
101 GH      horizontal line
102 GV      vertical line
103 GC      intersection
104 G6      upper left
105 G7      lower left
106 G5      upper right
107 G8      lower right
108 Gr      tee pointing right
109 Gr      tee pointing left
110 Gu      tee pointing up
111 Gd      tee pointing down
112 Gh      horizontal line
113 Gv      vertical line
114 Gc      intersection
115 GG      acs magic cookie count
116 .TE
117 .PP
118 If the single-line capabilities occur in an entry, they will automatically
119 be composed into an \fBacsc\fR string.  The double-line capabilities and
120 \fBGG\fR are discarded with a warning message.
121 .PP
122 IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible
123 with the SVr4 format. The following AIX extensions are automatically
124 translated:
125 .PP
126 .TS
127 c c
128 l l.
129 IBM     XSI
130 _
131 ksel    kslt
132 kbtab   kcbt
133 font0   s0ds
134 font1   s1ds
135 font2   s2ds
136 font3   s3ds
137 .TE
138 .PP
139 Additionally, the AIX \fBbox1\fR capability will be automatically translated to
140 an \fBacsc\fR string.
141 .PP
142 Hewlett-Packard's terminfo library supports two nonstandard terminfo 
143 capabilities \fBmeml\fR (memory lock) and \fBmemu\fR (memory unlock).
144 These will be discarded with a warning message.
145 .SH NOTES
146 This utility is actually a link to \fItic\fR(1M), running in \fI-I\fR mode.
147
148 The trace option isn't identical to SVr4's.  Under SVr4, instead of following
149 the -v with a trace level n, you repeat it n times.
150 .SH SEE ALSO
151 \fBcurses\fR(3X), \fBinfocmp\fR(1M), \fBterminfo\fR(\*n)
152 .SH AUTHOR
153 Eric S. Raymond <esr@snark.thyrsus.com>
154 .\"#
155 .\"# The following sets edit modes for GNU EMACS
156 .\"# Local Variables:
157 .\"# mode:nroff
158 .\"# fill-column:79
159 .\"# End: