'

NAME
     captoinfo - convert a termcap description into a terminfo description

SYNOPSIS
     captoinfo [-v ...] [-V] [-1] [-w width] file...

DESCRIPTION
     captoinfo looks in file for termcap descriptions.  For each one found, an
     equivalent terminfo(4) description is written to standard output, along
     with any comments found.  A description that is expressed as relative to
     another description (as specified in the termcap tc= field) reduces to
     the minimum superset before being output.

     If no file is given, then use the environment variable TERMCAP for the
     filename or entry.  If TERMCAP is a full pathname to a file, only the
     terminal whose name is specified in the environment variable TERM is
     extracted from that file.  If the environment variable TERMCAP is not
     set, then read the file /etc/termcap.

OPTIONS
     -v        Prints tracing information on standard error as the program
               runs.  Specifying additional -v options causes more detailed
               information to be printed.

     -V        Prints the version of the program in use on standard error and
               exit.

     -1        Causes the fields to print one to a line.  Otherwise, the
               fields are printed several to a line, up to a maximum width of
               60 characters.

     -wwidth   Changes the output to width characters.

NOTES
     captoinfo should be used to convert termcap entries to terminfo(4)
     entries since the termcap database may not be supplied in future
     releases.

     The short two-letter name at the beginning of the list of names in a
     termcap entry has been removed.

CAVEATS
     Certain termcap defaults are assumed to be true.  For example, the bell
     character (terminfo bel) is assumed to be CTRL/G.  The linefeed
     capability (termcap nl) is assumed to be the same for both cursor_down
     and scroll_forward (terminfo cud1 and ind, respectively.) Padding
     information is assumed to belong at the end of the string.

     The algorithm used to expand parameterized information for termcap fields
     such as cursor_position (termcap cm, terminfo cup) sometimes produces a
     string which, though technically correct, may not be optimal.  In
     particular, the rarely used termcap operation %n produces strings that
     are especially long.  Most occurrences of these non-optimal strings are
     flagged with a warning message and may need to be recoded by hand.

FILES
     /usr/lib/terminfo/?/*
                    Compiled terminal description database

DIAGNOSTICS
     tgetent failed with return code n (reason).
                    The termcap entry is not valid.  In particular, check for
                    an invalid 'tc=' entry.

     unknown type given for the termcap code cc.
                    The termcap description had an entry for cc whose type was
                    not Boolean, numeric or string.

     wrong type given for the boolean (numeric, string)
     termcap code cc.
                    The Boolean termcap entry cc was entered as a numeric or
                    string capability.

     the boolean (numeric, string) termcap code cc is not
     a valid name.
                    An unknown termcap code was specified.

     tgetent failed on TERM=term.
                    The terminal type specified could not be found in the
                    termcap file.

     TERM=term: cap cc (info ii) is NULL: REMOVED
                    The termcap code was specified as a null string.  The
                    correct way to cancel an entry is with an '@', as in
                    ':bs@:'.  Giving a null string could cause incorrect
                    assumptions to be made by the software which uses termcap
                    or terminfo.

     a function key for cc was specified, but it already
     has the value vv.
                    When parsing the ko capability, the key cc was specified
                    as having the same value as the capability cc, but the key
                    cc already had a value assigned to it.

     the unknown termcap name cc was specified in the
     ko termcap capability.
                    A key was specified in the ko capability which could not
                    be handled.

     the vi character v (info ii1) has the value xx,
     but ma gives n.
                    The ma capability specified a function key with a value
                    different from that specified in another setting of the
                    same key.

     the unknown vi key v was specified in the ma
     termcap capability.
                    A vi(1) key unknown to captoinfo was specified in the ma
                    capability.

     Warning: termcap sg (nn) and termcap ug (nn) had
     different values.
                    terminfo assumes that the sg (now xmc) and ug values were
                    the same.

     Warning: the string produced for ii may be inefficient.
                    The parameterized string being created should be rewritten
                    by hand.

     Null termname given.
                    The terminal type was null.  This is given if the
                    environment variable TERM is not set or is null.

     cannot open file for reading.
                    The specified file could not be opened.  "'.SH AUTHOR
                    "'Tony Hansen.

SEE ALSO
     infocmp(1M), tic(1M).
     curses (3X), terminfo(4)