X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcaptoinfo.1m.html;h=4d1c8ce384b55f654940e3f5fa5cd0a12806b7b3;hb=2882050bf8b296813e7e026b1c5c45d4a23043e3;hp=b832f9589c0d4f833473b8405816c8f119e55998;hpb=205ea499dbbceba5201d997fbd8b6b1f7f29bd50;p=ncurses.git diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html index b832f958..4d1c8ce3 100644 --- a/doc/html/man/captoinfo.1m.html +++ b/doc/html/man/captoinfo.1m.html @@ -1,7 +1,7 @@ -captoinfo 1m +captoinfo 1m 2023-10-14 ncurses 6.4 User commands -

captoinfo 1m

+

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

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

SYNOPSIS

-       captoinfo [-vn width]  [-V] [-1] [-w width] file ...
+       captoinfo [tic-option] [file ...]
 
+       captoinfo -V
 
-

DESCRIPTION

-       captoinfo  looks in each given text file for termcap descriptions.  For
-       each one found,  an  equivalent  terminfo  description  is  written  to
-       standard  output.   Termcap  tc capabilities are translated directly to
-       terminfo 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.
-
-       -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.
 
-
-

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
-       automatically  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  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.  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.
+
+       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
@@ -172,20 +166,22 @@
        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
+
 
+

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.
+       following the -v with a trace level n, you repeat it n times.
 
 
 

PORTABILITY

@@ -196,31 +192,32 @@
        NetBSD does not provide this application.
 
 
-

SEE ALSO

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

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