captoinfo 1m 2023-10-07 ncurses 6.4 User commands

captoinfo(1m)                    User commands                   captoinfo(1m)




NAME

       captoinfo - convert a termcap description into a terminfo description


SYNOPSIS

       captoinfo [tic-option] [file ...]

       captoinfo -V


DESCRIPTION

       captoinfo  looks in each given text file for termcap descriptions.  For
       each one found, it writes an equivalent  terminfo  description  to  the
       standard   output  stream.   termcap  tc  capabilities  are  translated
       directly to terminfo "use" capabilities.

       If no files are specified, captoinfo  interprets  the  content  of  the
       environment  variable  TERMCAP  as  a  file name, and extracts only the
       entry for the terminal named in the environment variable TERM from  it.
       If  the  environment  variable  TERMCAP  is  not  set,  captoinfo reads
       /etc/termcap.

       This utility is implemented as a link to tic(1m), with the latter's  -I
       option  implied.  You can use other tic options such as -1, -f, -v, -w,
       and -x.


Translations from nonstandard capabilities

       captoinfo  translates  some  obsolete,  nonstandard  capabilities  into
       standard   (SVr4/XSI   Curses)  terminfo  capabilities.   It  issues  a
       diagnostic to the standard error stream for each, inviting the user  to
       check  that  it  has  not  mistakenly translated an unknown or mistyped
       capability name.

       Nonstandard   Standard                  tteerrmmiinnffoo
          name         name     From          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 had a set of extension capabilities, corresponding to box
       drawing characters of CCSID ("code page") 437, as follows.

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

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

       IBM's  AIX  has  a  terminfo facility descended from SVr1 terminfo, but
       which is incompatible with the SVr4 format.  captoinfo  translates  the
       following AIX extensions.

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

       Additionally,  this  program  translates  the AIX box1 capability to an
       acsc string.

       The  HP-UX  terminfo  library   supports   two   nonstandard   terminfo
       capabilities,  meml  (memory lock) and memu (memory unlock).  captoinfo
       discards these with a warning message.


FILES

       /etc/termcap
              default termcap terminal capability database


NOTES

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


PORTABILITY

       X/Open  Curses,  Issue  7  (2009) describes tic briefly, but omits this
       program.  SVr4 systems provide captoinfo as a separate application from
       tic.

       NetBSD does not provide this application.


AUTHOR

       Eric S. Raymond <esr@snark.thyrsus.com> and
       Thomas E. Dickey <dickey@invisible-island.net>


SEE ALSO

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



ncurses 6.4                       2023-10-07                     captoinfo(1m)