X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcaptoinfo.1m.html;h=9531a372c5d08669581676d499ae83c8e1b62c2a;hb=09ed0227b324243f636e31d876e3dc30dfc7a778;hp=847aa5f56cc047c44fd287cffe2459fe88070bf1;hpb=54d0d62f0eb759e3c623a215d98ddebccca64488;p=ncurses.git diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html index 847aa5f5..9531a372 100644 --- a/doc/html/man/captoinfo.1m.html +++ b/doc/html/man/captoinfo.1m.html @@ -1,7 +1,7 @@ - -captoinfo 1m +captoinfo 1m 2023-12-02 ncurses 6.4 User commands - + -

captoinfo 1m

+

captoinfo 1m 2023-12-02 ncurses 6.4 User commands

-captoinfo(1m)                                                    captoinfo(1m)
+captoinfo(1m)                    User commands                   captoinfo(1m)
 
 
 
@@ -52,118 +56,106 @@
 
 
 

SYNOPSIS

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

DESCRIPTION

-       captoinfo  looks in each given text file for termcap descriptions.  For
-       each one found, an equivalent terminfo description is written to  stan-
-       dard  output.   Termcap tc capabilities are translated directly to ter-
-       minfo 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 specified 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.
+       captoinfo [tic-option] [file ...]
 
-       -V   print  out the version of the program in use on standard error and
-            exit.
+       captoinfo -V
 
-       -1   cause the fields to print out  one  to  a  line.   Otherwise,  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 automatic 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 capabilities 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 automati-
-       cally be 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
-       incompatible with the SVr4 format.  The following  AIX  extensions  are
-       automatically translated:
-
-        IBM    XSI
+

DESCRIPTION

+       captoinfo  translates  terminal  descriptions.   It looks in each given
+       text file for termcap entries  and,  for  each  one  found,  writes  an
+       equivalent terminfo description to the standard output stream.  termcap
+       tc capabilities translate 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.  The -V option reports the version of ncurses  associated  with
+       this program and exits with a successful status.
+
+
+

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.
+
+              Name
+       Obsolete   Standard    Origin      tteerrmmiinnffoo 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;      Tektronix   key_f10
+          KB         F1      Tektronix   key_f11
+          KC         F2      Tektronix   key_f12
+          KD         F3      Tektronix   key_f13
+          KE         F4      Tektronix   key_f14
+          KF         F5      Tektronix   key_f15
+          BC         Sb      Tektronix   set_background
+
+          FC         Sf      Tektronix   set_foreground
+          HS         mh        IRIX      enter_dim_mode
+
+       XENIX termcap had a set of extension capabilities, corresponding to box
+       drawing characters of CCSID ("code page") 437, as follows.
+
+       tteerrmmccaapp 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
+
+       captoinfo composes single-line capabilities into an  acsc  string,  and
+       discards GG and double-line capabilities with a warning diagnostic.
+
+       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
@@ -172,55 +164,58 @@
        font2   s2ds
        font3   s3ds
 
-       Additionally,  the AIX box1 capability will be automatically translated
-       to an acsc string.
+       Additionally,  this  program  translates  the AIX box1 capability to an
+       acsc string.
 
-       Hewlett-Packard's terminfo library supports  two  nonstandard  terminfo
-       capabilities  meml  (memory lock) and memu (memory unlock).  These will
-       be discarded with a warning message.
+       The  HP-UX  terminfo  library   supports   two   nonstandard   terminfo
+       capabilities,  meml  (memory lock) and memu (memory unlock).  captoinfo
+       discards these 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.
+

FILES

+       /etc/termcap
+              default termcap terminal capability database
 
-       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.
+
+

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
+       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.
 
 
-

SEE ALSO

-       infocmp(1m), curses(3x), terminfo(5)
-
-       This describes ncurses version 6.2 (patch 20200516).
-
-
-

AUTHOR

+

AUTHORS

        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)
+
+
 
-                                                                 captoinfo(1m)
+ncurses 6.4                       2023-12-02                     captoinfo(1m)