# captoinfo 1m

    captoinfo(1m)                                             captoinfo(1m)

## NAME

           captoinfo  - convert a termcap description into a terminfo
           description

## SYNOPSIS

           captoinfo [-vn width]  [-V] [-1] [-w width] file . . .

## DESCRIPTION

           captoinfo looks in file  for  termcap  descriptions.   For
           each  one  found,  an  equivalent  terminfo description is
           written to standard output.  Termcap tc  capabilities  are
           translated directly to terminfo use capabilities.

           If no file is given, then the environment variable TERMCAP
           is used for the filename or entry.  If TERMCAP is  a  full
           pathname to a file, only the terminal whose name is speci-
           fied in the environment variable TERM  is  extracted  from
           that  file.   If  the  environment variable TERMCAP is not
           set, then the file /usr/share/terminfo is read.

           -v   print out tracing information on  standard  error  as
                the program runs.

           -V   print  out the version of the program in use on stan-
                dard error and exit.

           -1   cause the fields to print out one to a line.   Other-
                wise, the fields will be printed several to a line to
                a maximum width of 60 characters.

           -w   change the output to width characters.

## FILES

           /usr/share/terminfo Compiled     terminal      description
                               database.

## TRANSLATIONS FROM NONSTANDARD CAPABILITIES

           Some  obsolete nonstandard capabilities will automatically
           be translated into  standard  (SVr4/XSI  Curses)  terminfo
           capabilities  by  captoinfo.   Whenever one of these auto-
           matic translations is done,  the  program  will  issue  an
           notification to stderr, inviting the user to check that it
           has not mistakenly translated  a  completely  unknown  and
           random capability and/or syntax error.

           Nonstd   Std    From           Terminfo
            name    name                 capability
           -----------------------------------------------
           BO       mr     AT&T    enter_reverse_mode
           CI       vi     AT&T    cursor_invisible
           CV       ve     AT&T    cursor_normal
           DS       mh     AT&T    enter_dim_mode
           EE       me     AT&T    exit_attribute_mode
           FE       LF     AT&T    label_on
           FL       LO     AT&T    label_off
           XS       mk     AT&T    enter_secure_mode
           EN       @7     XENIX   key_end
           GE       ae     XENIX   exit_alt_charset_mode
           GS       as     XENIX   enter_alt_charset_mode
           HM       kh     XENIX   key_home

           LD       kL     XENIX   key_dl
           PD       kN     XENIX   key_npage
           PN       po     XENIX   prtr_off
           PS       pf     XENIX   prtr_on
           PU       kP     XENIX   key_ppage
           RT       @8     XENIX   kent
           UP       ku     XENIX   kcuu1
           KA       k;     Tek     key_f10
           KB       F1     Tek     key_f11
           KC       F2     Tek     key_f12
           KD       F3     Tek     key_f13
           KE       F4     Tek     key_f14
           KF       F5     Tek     key_f15
           BC       Sb     Tek     set_background
           FC       Sf     Tek     set_foreground
           HS       mh     Iris    enter_dim_mode

           XENIX  termcap  also used to have a set of extension capa-
           bilities for forms drawing, designed to take advantage  of
           the IBM PC high-half graphics.  They were as follows:

           Cap          Graphic
           -----------------------------
           G2    upper left
           G3    lower left
           G1    upper right
           G4    lower right
           GR    pointing right
           GL    pointing left
           GU    pointing up
           GD    pointing down
           GH    horizontal line
           GV    vertical line
           GC    intersection
           G6    upper left
           G7    lower left
           G5    upper right
           G8    lower right
           Gr    tee pointing right
           Gr    tee pointing left
           Gu    tee pointing up
           Gd    tee pointing down
           Gh    horizontal line
           Gv    vertical line
           Gc    intersection
           GG    acs magic cookie count

           If  the  single-line  capabilities occur in an entry, they
           will automatically be composed into an acsc  string.   The
           double-line capabilities and GG are discarded with a warn-
           ing message.

           IBM's AIX has a terminfo facility descended from SVr1 ter-
           minfo but incompatible with the SVr4 format. The following
           AIX extensions are automatically translated:

            IBM    XSI
           -------------
           ksel    kslt
           kbtab   kcbt
           font0   s0ds
           font1   s1ds
           font2   s2ds
           font3   s3ds

           Additionally, the AIX box1 capability  will  be  automati-
           cally translated to an acsc string.

           Hewlett-Packard's  terminfo  library supports two nonstan-
           dard terminfo capabilities meml  (memory  lock)  and  memu
           (memory  unlock).   These will be discarded with a warning
           message.

## NOTES

           This utility is actually a link to tic(1m), running in  -I
           mode.  You can use other tic options such as -f and  -x.

           The  trace option is not identical to SVr4's.  Under SVr4,
           instead of following the -v with  a  trace  level  n,  you
           repeat it n times.

## SEE ALSO

           infocmp(1m), curses(3x), terminfo(5)

           This describes ncurses version 5.6 (patch 20081011).

## AUTHOR

           Eric S. Raymond <esr@snark.thyrsus.com>

                                                              captoinfo(1m)