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 speci-
  27        fied in the environment variable <B>TERM</B>  is  extracted  from
  28        that  file.   If  the  environment variable <B>TERMCAP</B> is not
  29        set, then the file <B>@DATADIR@/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 stan-
  35             dard error and exit.
  36
  37        <B>-1</B>   cause the fields to print out one to a line.   Other-
  38             wise, the fields will be printed several to a line to
  39             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        @DATADIR@/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 auto-
  55        matic 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 capa-
  94        bilities for forms drawing, designed to take advantage  of
  95        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 warn-
 126        ing message.
 127
 128        IBM's AIX has a terminfo facility descended from SVr1 ter-
 129        minfo but incompatible with the SVr4 format. The following
 130        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  automati-
 142        cally translated to an <B>acsc</B> string.
 143
 144        Hewlett-Packard's  terminfo  library supports two nonstan-
 145        dard terminfo capabilities <B>meml</B>  (memory  lock)  and  <B>memu</B>
 146        (memory  unlock).   These will be discarded with a warning
 147        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>