captoinfo(1M)                                                 captoinfo(1M)




 NAME    [Toc]    [Back]
      captoinfo - convert a termcap description into a terminfo description

 SYNOPSIS    [Toc]    [Back]
      captoinfo [-1v] [-wn] [filenames]

 DESCRIPTION    [Toc]    [Back]
      captoinfo looks in filenames for termcap(3X) descriptions.  For each
      one found, an equivalent terminfo(4) description is written to
      standard output along with any comments found.  The short two letter
      name at the beginning of the list of names in a termcap entry, a
      holdover from Version 6 UNIX, is removed.  Any description that is
      expressed relative to another description (as specified in the termcap
      tc= field) is reduced to the minimum superset before output.

      If no filename is given, 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 specified in the environment variable TERM
      is extracted from that file.  If the environment variable TERMCAP is
      not set, the file /usr/share/lib/termcap is read.

    Options    [Toc]    [Back]
      captoinfo recognizes the following options:

           -1   Print one field per line.  If this option is not selected,
                multiple fields are printed on each line up to a maximum
                width of 60 characters.

           -v   Print (verbose) tracing information as the program runs.
                Additional -v options print more information (for example -v
                -v -v or -vvv).

           -wn  Change the output width to n characters.

 DIAGNOSTICS    [Toc]    [Back]
      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.





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 captoinfo(1M)                                                 captoinfo(1M)




      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 any software that 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 that could not be handled was specified in the 'ko'
                capability.

      the vi character 'v' (info 'ii') 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 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.    [Toc]    [Back]
                The terminal type was null.  This occurs when $TERM is null
                or not set.

      cannot open "file" for reading.
                The specified file could not be opened.

      Warning: cannot translate capability (unsupported in terminfo).
                This termcap capability is no longer supported in terminfo,
                and therefore cannot be translated.

 WARNINGS    [Toc]    [Back]
      Certain termcap defaults are assumed to be true.  For example, the
      bell character (terminfo bel) is assumed to be ^G.  The linefeed
      capability (termcap nl) is assumed to be the same for both cursor_down



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 captoinfo(1M)                                                 captoinfo(1M)




      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 less than
      optimal strings are flagged with a warning message, and may need to be
      recoded by hand.

      HP supports only terminals listed on the current list of supported
      devices.  However, the terminfo database contains both supported and
      nonsupported terminals.  If you use nonsupported terminals, they may
      not work correctly.

 AUTHOR    [Toc]    [Back]
      captoinfo was developed by AT&T.

 SEE ALSO    [Toc]    [Back]
      tic(1M), untic(1M), termcap(3X), terminfo(4), infocmp(1M).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003