search..
No manual entry for -- in section 1
captoinfo(1)			 User commands			   captoinfo(1)

NAME
       captoinfo - convert a termcap description into a terminfo description

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

       captoinfo -V

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 capabil-
       ities translate to terminfo "use" capabilities.

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

       This utility is implemented as a link to tic(1), 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 stan-
       dard terminfo capabilities.  It issues a diagnostic to the standard  er-
       ror  stream for each, inviting the user to check that it has not mistak-
       enly translated an unknown or mistyped capability name.

		  termcap Code
	       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 Code	       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    X/Open
				    ---------------
				    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  capabili-
       ties,  meml  (memory lock) and memu (memory unlock).  captoinfo discards
       these with a warning message.

FILES
       /etc/termcap
	      default termcap terminal capability database

PORTABILITY
       X/Open Curses Issue 7 (2009) describes tic briefly, but omits this  pro-
       gram.

       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.

       NetBSD does not provide this application.

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

SEE ALSO
       infocmp(1), tic(1), ncurses(3NCURSES), terminfo(5)

ncurses 6.5			   2025-01-18			   captoinfo(1)