ncurses 5.2
[ncurses.git] / doc / html / man / captoinfo.1m.html
1 <HTML>
2 <BODY>
3 <PRE>
4 <!-- Manpage converted by man2html 3.0.1 -->
5
6 </PRE>
7 <H2>NAME</H2><PRE>
8        <B>captoinfo</B>  - convert a <I>termcap</I> description into a <I>terminfo</I>
9        description
10
11
12 </PRE>
13 <H2>SYNOPSIS</H2><PRE>
14        <B>captoinfo</B> [<B>-v</B><I>n</I> <I>width</I>]  [<B>-V</B>] [<B>-1</B>] [<B>-w</B> <I>width</I>] <I>file</I> . . .
15
16
17 </PRE>
18 <H2>DESCRIPTION</H2><PRE>
19        <B>captoinfo</B> looks in <I>file</I>  for  <B>termcap</B>  descriptions.   For
20        each  one  found,  an  equivalent  <B>terminfo</B> description is
21        written to standard output.  Termcap <B>tc</B>  capabilities  are
22        translated directly to terminfo <B>use</B> capabilities.
23
24        If no <I>file</I> is given, then the environment variable <B>TERMCAP</B>
25        is used for the filename or entry.  If <B>TERMCAP</B> is  a  full
26        pathname  to  a  file,  only  the  terminal  whose name is
27        specified in the environment variable  <B>TERM</B>  is  extracted
28        from  that  file.   If the environment variable <B>TERMCAP</B> is
29        not set, then the file <B>/usr/share/terminfo</B> is read.
30
31        <B>-v</B>   print out tracing information on  standard  error  as
32             the program runs.
33
34        <B>-V</B>   print  out  the  version  of  the  program  in use on
35             standard error and exit.
36
37        <B>-1</B>   cause  the  fields  to  print  out  one  to  a  line.
38             Otherwise,  the  fields  will be printed several to a
39             line to a maximum width of 60 characters.
40
41        <B>-w</B>   change the output to <I>width</I> characters.
42
43
44 </PRE>
45 <H2>FILES</H2><PRE>
46        /usr/share/terminfo Compiled     terminal      description
47                            database.
48
49
50 </PRE>
51 <H2>TRANSLATIONS FROM NONSTANDARD CAPABILITIES</H2><PRE>
52        Some  obsolete nonstandard capabilities will automatically
53        be translated into  standard  (SVr4/XSI  Curses)  terminfo
54        capabilities   by   <B>captoinfo</B>.    Whenever  one  of  these
55        automatic translations is done, the program will issue  an
56        notification to stderr, inviting the user to check that it
57        has not mistakenly translated  a  completely  unknown  and
58        random capability and/or syntax error.
59
60        Nonstd   Std    From           Terminfo
61         name    name                 capability
62        -----------------------------------------------
63        BO       mr     AT&amp;T    enter_reverse_mode
64        CI       vi     AT&amp;T    cursor_invisible
65        CV       ve     AT&amp;T    cursor_normal
66        DS       mh     AT&amp;T    enter_dim_mode
67        EE       me     AT&amp;T    exit_attribute_mode
68
69        FE       LF     AT&amp;T    label_on
70        FL       LO     AT&amp;T    label_off
71        XS       mk     AT&amp;T    enter_secure_mode
72        EN       @7     XENIX   key_end
73        GE       ae     XENIX   exit_alt_charset_mode
74        GS       as     XENIX   enter_alt_charset_mode
75        HM       kh     XENIX   key_home
76        LD       kL     XENIX   key_dl
77        PD       kN     XENIX   key_npage
78        PN       po     XENIX   prtr_off
79        PS       pf     XENIX   prtr_on
80        PU       kP     XENIX   key_ppage
81        RT       @8     XENIX   kent
82        UP       ku     XENIX   kcuu1
83        KA       k;     Tek     key_f10
84        KB       F1     Tek     key_f11
85        KC       F2     Tek     key_f12
86        KD       F3     Tek     key_f13
87        KE       F4     Tek     key_f14
88        KF       F5     Tek     key_f15
89        BC       Sb     Tek     set_background
90        FC       Sf     Tek     set_foreground
91        HS       mh     Iris    enter_dim_mode
92
93        XENIX  termcap  also  used  to  have  a  set  of extension
94        capabilities for forms drawing, designed to take advantage
95        of the IBM PC high-half graphics.  They were as follows:
96
97        Cap          Graphic
98        -----------------------------
99        G2    upper left
100        G3    lower left
101        G1    upper right
102        G4    lower right
103        GR    pointing right
104        GL    pointing left
105        GU    pointing up
106        GD    pointing down
107        GH    horizontal line
108        GV    vertical line
109        GC    intersection
110        G6    upper left
111        G7    lower left
112        G5    upper right
113        G8    lower right
114        Gr    tee pointing right
115        Gr    tee pointing left
116        Gu    tee pointing up
117        Gd    tee pointing down
118        Gh    horizontal line
119        Gv    vertical line
120        Gc    intersection
121        GG    acs magic cookie count
122
123        If  the  single-line  capabilities occur in an entry, they
124        will automatically be composed into an <B>acsc</B>  string.   The
125        double-line  capabilities  and  <B>GG</B>  are  discarded  with a
126        warning message.
127
128        IBM's AIX has a  terminfo  facility  descended  from  SVr1
129        terminfo  but  incompatible  with  the  SVr4  format.  The
130        following AIX extensions are automatically translated:
131
132         IBM    XSI
133        -------------
134        ksel    kslt
135        kbtab   kcbt
136        font0   s0ds
137        font1   s1ds
138        font2   s2ds
139        font3   s3ds
140
141        Additionally,   the   AIX   <B>box1</B>   capability   will    be
142        automatically translated to an <B>acsc</B> string.
143
144        Hewlett-Packard's    terminfo    library    supports   two
145        nonstandard terminfo capabilities <B>meml</B> (memory  lock)  and
146        <B>memu</B>  (memory  unlock).   These  will  be discarded with a
147        warning message.
148
149
150 </PRE>
151 <H2>NOTES</H2><PRE>
152        This utility is actually a link to <B><A HREF="tic.1m.html">tic(1m)</A></B>, running in  <I>-I</I>
153        mode.  You can use other <I>tic</I> options such as <B>-f</B> and  <B>-x</B>.
154
155        The  trace  option isn't identical to SVr4's.  Under SVr4,
156        instead of following the -v with  a  trace  level  n,  you
157        repeat it n times.
158
159
160 </PRE>
161 <H2>SEE ALSO</H2><PRE>
162        <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B>, <B><A HREF="terminfo.5.html">terminfo(5)</A></B>
163
164
165 </PRE>
166 <H2>AUTHOR</H2><PRE>
167        Eric S. Raymond &lt;esr@snark.thyrsus.com&gt;
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183 </PRE>
184 <HR>
185 <ADDRESS>
186 Man(1) output converted with
187 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
188 </ADDRESS>
189 </BODY>
190 </HTML>