X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcaptoinfo.1m.html;h=4d21efbf72d9d1114d99e89f08687e3a7b0168ea;hp=63fc205f7283a09ca9f34ce131338cf1c40338dd;hb=HEAD;hpb=cb4427a16794d98049b4d790b810d62217501f9f diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html index 63fc205f..fcf71ff7 100644 --- a/doc/html/man/captoinfo.1m.html +++ b/doc/html/man/captoinfo.1m.html @@ -1,7 +1,8 @@ - -captoinfo 1m +captoinfo 1m 2024-03-23 ncurses 6.4 User commands - + -

captoinfo 1m

+

captoinfo 1m 2024-03-23 ncurses 6.4 User commands

-captoinfo(1m)                                                    captoinfo(1m)
+captoinfo(1m)                    User commands                   captoinfo(1m)
 
 
 
@@ -51,166 +52,163 @@
 
 
 

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.
+       captoinfo [tic-option] [file ...]
 
-       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.
+       captoinfo -V
 
-       -v   print out tracing information on standard  error  as  the  program
-            runs.
 
-       -V   print  out the version of the program in use on standard error and
-            exit.
-
-       -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.
+

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

-       /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
-       -------------
-       ksel    kslt
-       kbtab   kcbt
-       font0   s0ds
-       font1   s1ds
-       font2   s2ds
-       font3   s3ds
-
-       Additionally,  the AIX box1 capability will be automatically translated
-       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.
-
-
-

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.
-
-       The  trace  option  is not identical to SVr4's.  Under SVr4, instead of
-       following the -v with a trace level n, you repeat it n times.
+       /etc/termcap
+              default termcap terminal capability database
 
 
-

SEE ALSO

-       infocmp(1m), curses(3x), terminfo(5)
+

PORTABILITY

+       X/Open Curses, Issue 7 (2009) describes tic  briefly,  but  omits  this
+       program.
+
+       SVr4 systems provide captoinfo as a separate application from tic.  Its
+       -v option does not accept a trace level argument n; repeat -v  n  times
+       instead.
 
-       This describes ncurses version 6.1 (patch 20190316).
+       NetBSD does not provide this application.
 
 
-

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                       2024-03-23                     captoinfo(1m)