man/captoinfo.1m

   1 '\" t
   2 .TH captoinfo 1M ""
   3 .ds n 5
   4 .ds d @DATADIR@/terminfo
   5 .SH NAME
   6 \fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description
   7 .SH SYNOPSIS
   8 \fBcaptoinfo\fR [\fB-v\fIn\fR \fIwidth\fR]  [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . .
   9 .SH DESCRIPTION
  10 \fBcaptoinfo\fR looks in \fIfile\fR for \fBtermcap\fR descriptions.  For each
  11 one found, an equivalent \fBterminfo\fR description is written to standard
  12 output.  Termcap \fBtc\fR capabilities are translated directly to terminfo
  13 \fBuse\fR capabilities.
  14
  15 If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used
  16 for the filename or entry.  If \fBTERMCAP\fR is a full pathname to a file, only
  17 the terminal whose name is specified in the environment variable \fBTERM\fR is
  18 extracted from that file.  If the environment variable \fBTERMCAP\fR is not
  19 set, then the file \fB\*d\fR is read.
  20 .TP 5
  21 \fB-v\fR
  22 print out tracing information on standard error as the program runs.
  23 .TP 5
  24 \fB-V\fR
  25 print out the version of the program in use on standard error and exit.
  26 .TP 5
  27 \fB-1\fR
  28 cause the fields to print out one to a line.  Otherwise, the fields
  29 will be printed several to a line to a maximum width of 60
  30 characters.
  31 .TP 5
  32 \fB-w\fR
  33 change the output to \fIwidth\fR characters.
  34 .SH FILES
  35 .TP 20
  36 \*d
  37 Compiled terminal description database.
  38 .SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES
  39 .PP
  40 Some obsolete nonstandard capabilities will automatically be translated
  41 into standard (SVr4/XSI Curses) terminfo capabilities by \fBcaptoinfo\fR.
  42 Whenever one of these automatic translations is done, the program
  43 will issue an notification to stderr, inviting the user to check that
  44 it has not mistakenly translated a completely unknown and random
  45 capability and/or syntax error.
  46 .PP
  47 .TS H
  48 c c c c
  49 c c c c
  50 l l l l.
  51 Nonstd  Std     From    Terminfo
  52 name    name            capability
  53 _
  54 BO      mr      AT&T    enter_reverse_mode
  55 CI      vi      AT&T    cursor_invisible
  56 CV      ve      AT&T    cursor_normal
  57 DS      mh      AT&T    enter_dim_mode
  58 EE      me      AT&T    exit_attribute_mode
  59 FE      LF      AT&T    label_on
  60 FL      LO      AT&T    label_off
  61 XS      mk      AT&T    enter_secure_mode
  62 EN      @7      XENIX   key_end
  63 GE      ae      XENIX   exit_alt_charset_mode
  64 GS      as      XENIX   enter_alt_charset_mode
  65 HM      kh      XENIX   key_home
  66 LD      kL      XENIX   key_dl
  67 PD      kN      XENIX   key_npage
  68 PN      po      XENIX   prtr_off
  69 PS      pf      XENIX   prtr_on
  70 PU      kP      XENIX   key_ppage
  71 RT      @8      XENIX   kent
  72 UP      ku      XENIX   kcuu1
  73 KA      k;      Tek     key_f10
  74 KB      F1      Tek     key_f11
  75 KC      F2      Tek     key_f12
  76 KD      F3      Tek     key_f13
  77 KE      F4      Tek     key_f14
  78 KF      F5      Tek     key_f15
  79 BC      Sb      Tek     set_background
  80 FC      Sf      Tek     set_foreground
  81 HS      mh      Iris    enter_dim_mode
  82 .TE
  83 .PP
  84 XENIX termcap also used to have a set of extension capabilities
  85 for forms drawing, designed to take advantage of the IBM PC
  86 high-half graphics.  They were as follows:
  87 .PP
  88 .TS H
  89 c c
  90 l l.
  91 Cap     Graphic
  92 _
  93 G2      upper left
  94 G3      lower left
  95 G1      upper right
  96 G4      lower right
  97 GR      pointing right
  98 GL      pointing left
  99 GU      pointing up
 100 GD      pointing down
 101 GH      horizontal line
 102 GV      vertical line
 103 GC      intersection
 104 G6      upper left
 105 G7      lower left
 106 G5      upper right
 107 G8      lower right
 108 Gr      tee pointing right
 109 Gr      tee pointing left
 110 Gu      tee pointing up
 111 Gd      tee pointing down
 112 Gh      horizontal line
 113 Gv      vertical line
 114 Gc      intersection
 115 GG      acs magic cookie count
 116 .TE
 117 .PP
 118 If the single-line capabilities occur in an entry, they will automatically
 119 be composed into an \fBacsc\fR string.  The double-line capabilities and
 120 \fBGG\fR are discarded with a warning message.
 121 .PP
 122 IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible
 123 with the SVr4 format. The following AIX extensions are automatically
 124 translated:
 125 .PP
 126 .TS
 127 c c
 128 l l.
 129 IBM     XSI
 130 _
 131 ksel    kslt
 132 kbtab   kcbt
 133 font0   s0ds
 134 font1   s1ds
 135 font2   s2ds
 136 font3   s3ds
 137 .TE
 138 .PP
 139 Additionally, the AIX \fBbox1\fR capability will be automatically translated to
 140 an \fBacsc\fR string.
 141 .PP
 142 Hewlett-Packard's terminfo library supports two nonstandard terminfo
 143 capabilities \fBmeml\fR (memory lock) and \fBmemu\fR (memory unlock).
 144 These will be discarded with a warning message.
 145 .SH NOTES
 146 This utility is actually a link to \fItic\fR(1M), running in \fI-I\fR mode.
 147
 148 The trace option isn't identical to SVr4's.  Under SVr4, instead of following
 149 the -v with a trace level n, you repeat it n times.
 150 .SH SEE ALSO
 151 \fBcurses\fR(3X), \fBinfocmp\fR(1M), \fBterminfo\fR(\*n)
 152 .SH AUTHOR
 153 Eric S. Raymond <esr@snark.thyrsus.com>
 154 .\"#
 155 .\"# The following sets edit modes for GNU EMACS
 156 .\"# Local Variables:
 157 .\"# mode:nroff
 158 .\"# fill-column:79
 159 .\"# End: