| <!-- |
| * t |
| **************************************************************************** |
| * Copyright 2018-2023,2024 Thomas E. Dickey * |
| * Copyright 1998-2010,2016 Free Software Foundation, Inc. * |
| * * |
| * Permission is hereby granted, free of charge, to any person obtaining a * |
| * copy of this software and associated documentation files (the * |
| * "Software"), to deal in the Software without restriction, including * |
| * without limitation the rights to use, copy, modify, merge, publish, * |
| * distribute, distribute with modifications, sublicense, and/or sell * |
| * copies of the Software, and to permit persons to whom the Software is * |
| * furnished to do so, subject to the following conditions: * |
| * * |
| * The above copyright notice and this permission notice shall be included * |
| * in all copies or substantial portions of the Software. * |
| * * |
| * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * |
| * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * |
| * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * |
| * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * |
| * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * |
| * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * |
| * THE USE OR OTHER DEALINGS IN THE SOFTWARE. * |
| * * |
| * Except as contained in this notice, the name(s) of the above copyright * |
| * holders shall not be used in advertising or otherwise to promote the * |
| * sale, use or other dealings in this Software without prior written * |
| * authorization. * |
| **************************************************************************** |
| * @Id: captoinfo.1m,v 1.63 2024/03/23 20:37:25 tom Exp @ |
| --> |
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> |
| <HTML> |
| <HEAD> |
| <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> |
| <meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts"> |
| <TITLE>captoinfo 1m 2024-03-23 ncurses 6.5 User commands</TITLE> |
| <link rel="author" href="mailto:bug-ncurses@gnu.org"> |
| |
| </HEAD> |
| <BODY> |
| <H1 class="no-header">captoinfo 1m 2024-03-23 ncurses 6.5 User commands</H1> |
| <PRE> |
| <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG> User commands <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG> |
| |
| |
| |
| |
| </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE> |
| <STRONG>captoinfo</STRONG> - convert a <EM>termcap</EM> description into a <EM>terminfo</EM> description |
| |
| |
| </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE> |
| <STRONG>captoinfo</STRONG> [<EM>tic-option</EM>] [<EM>file</EM> ...] |
| |
| <STRONG>captoinfo</STRONG> <STRONG>-V</STRONG> |
| |
| |
| </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE> |
| <STRONG>captoinfo</STRONG> translates terminal descriptions. It looks in each given |
| text <EM>file</EM> for <EM>termcap</EM> entries and, for each one found, writes an |
| equivalent <EM>terminfo</EM> description to the standard output stream. <EM>termcap</EM> |
| <STRONG>tc</STRONG> capabilities translate to <EM>terminfo</EM> "<STRONG>use</STRONG>" capabilities. |
| |
| If no <EM>file</EM>s are specified, <STRONG>captoinfo</STRONG> interprets the content of the |
| environment variable <EM>TERMCAP</EM> as a file name, and extracts only the |
| entry for the terminal named in the environment variable <EM>TERM</EM> from it. |
| If the environment variable <EM>TERMCAP</EM> is not set, <STRONG>captoinfo</STRONG> reads |
| <EM>/etc/termcap</EM>. |
| |
| This utility is implemented as a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, with the latter's <STRONG>-I</STRONG> |
| option implied. You can use other <STRONG>tic</STRONG> options such as <STRONG>-1</STRONG>, <STRONG>-f</STRONG>, <STRONG>-v</STRONG>, <STRONG>-w</STRONG>, |
| and <STRONG>-x</STRONG>. The <STRONG>-V</STRONG> option reports the version of <EM>ncurses</EM> associated with |
| this program and exits with a successful status. |
| |
| |
| </PRE><H3><a name="h3-Translations-from-Nonstandard-Capabilities">Translations from Nonstandard Capabilities</a></H3><PRE> |
| <STRONG>captoinfo</STRONG> translates some obsolete, nonstandard capabilities into |
| standard (SVr4/XSI Curses) <EM>terminfo</EM> 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. |
| |
| <STRONG>Name</STRONG> |
| <STRONG>Obsolete</STRONG> <STRONG>Standard</STRONG> <STRONG>Origin</STRONG> <STRONG><EM>terminfo</EM></STRONG> <STRONG>capability</STRONG> |
| --------------------------------------------------------- |
| <STRONG>BO</STRONG> <STRONG>mr</STRONG> AT&T <STRONG>enter_reverse_mode</STRONG> |
| <STRONG>CI</STRONG> <STRONG>vi</STRONG> AT&T <STRONG>cursor_invisible</STRONG> |
| <STRONG>CV</STRONG> <STRONG>ve</STRONG> AT&T <STRONG>cursor_normal</STRONG> |
| <STRONG>DS</STRONG> <STRONG>mh</STRONG> AT&T <STRONG>enter_dim_mode</STRONG> |
| <STRONG>EE</STRONG> <STRONG>me</STRONG> AT&T <STRONG>exit_attribute_mode</STRONG> |
| <STRONG>FE</STRONG> <STRONG>LF</STRONG> AT&T <STRONG>label_on</STRONG> |
| <STRONG>FL</STRONG> <STRONG>LO</STRONG> AT&T <STRONG>label_off</STRONG> |
| <STRONG>XS</STRONG> <STRONG>mk</STRONG> AT&T <STRONG>enter_secure_mode</STRONG> |
| <STRONG>EN</STRONG> <STRONG>@7</STRONG> XENIX <STRONG>key_end</STRONG> |
| <STRONG>GE</STRONG> <STRONG>ae</STRONG> XENIX <STRONG>exit_alt_charset_mode</STRONG> |
| <STRONG>GS</STRONG> <STRONG>as</STRONG> XENIX <STRONG>enter_alt_charset_mode</STRONG> |
| <STRONG>HM</STRONG> <STRONG>kh</STRONG> XENIX <STRONG>key_home</STRONG> |
| <STRONG>LD</STRONG> <STRONG>kL</STRONG> XENIX <STRONG>key_dl</STRONG> |
| <STRONG>PD</STRONG> <STRONG>kN</STRONG> XENIX <STRONG>key_npage</STRONG> |
| <STRONG>PN</STRONG> <STRONG>po</STRONG> XENIX <STRONG>prtr_off</STRONG> |
| <STRONG>PS</STRONG> <STRONG>pf</STRONG> XENIX <STRONG>prtr_on</STRONG> |
| <STRONG>PU</STRONG> <STRONG>kP</STRONG> XENIX <STRONG>key_ppage</STRONG> |
| <STRONG>RT</STRONG> <STRONG>@8</STRONG> XENIX <STRONG>kent</STRONG> |
| <STRONG>UP</STRONG> <STRONG>ku</STRONG> XENIX <STRONG>kcuu1</STRONG> |
| <STRONG>KA</STRONG> <STRONG>k;</STRONG> Tektronix <STRONG>key_f10</STRONG> |
| <STRONG>KB</STRONG> <STRONG>F1</STRONG> Tektronix <STRONG>key_f11</STRONG> |
| <STRONG>KC</STRONG> <STRONG>F2</STRONG> Tektronix <STRONG>key_f12</STRONG> |
| <STRONG>KD</STRONG> <STRONG>F3</STRONG> Tektronix <STRONG>key_f13</STRONG> |
| <STRONG>KE</STRONG> <STRONG>F4</STRONG> Tektronix <STRONG>key_f14</STRONG> |
| <STRONG>KF</STRONG> <STRONG>F5</STRONG> Tektronix <STRONG>key_f15</STRONG> |
| <STRONG>BC</STRONG> <STRONG>Sb</STRONG> Tektronix <STRONG>set_background</STRONG> |
| |
| <STRONG>FC</STRONG> <STRONG>Sf</STRONG> Tektronix <STRONG>set_foreground</STRONG> |
| <STRONG>HS</STRONG> <STRONG>mh</STRONG> IRIX <STRONG>enter_dim_mode</STRONG> |
| |
| XENIX <EM>termcap</EM> had a set of extension capabilities, corresponding to box |
| drawing characters of CCSID ("code page") 437, as follows. |
| |
| <STRONG><EM>termcap</EM></STRONG> <STRONG>Name</STRONG> <STRONG>Graphic</STRONG> |
| ----------------------------------------- |
| <STRONG>G2</STRONG> upper left corner |
| <STRONG>G3</STRONG> lower left corner |
| <STRONG>G1</STRONG> upper right corner |
| <STRONG>G4</STRONG> lower right corner |
| <STRONG>GR</STRONG> tee pointing right |
| <STRONG>GL</STRONG> tee pointing left |
| <STRONG>GU</STRONG> tee pointing up |
| <STRONG>GD</STRONG> tee pointing down |
| <STRONG>GH</STRONG> horizontal line |
| <STRONG>GV</STRONG> vertical line |
| <STRONG>GC</STRONG> intersection |
| <STRONG>G6</STRONG> double upper left corner |
| <STRONG>G7</STRONG> double lower left corner |
| <STRONG>G5</STRONG> double upper right corner |
| <STRONG>G8</STRONG> double lower right corner |
| <STRONG>Gr</STRONG> double tee pointing right |
| <STRONG>Gr</STRONG> double tee pointing left |
| <STRONG>Gu</STRONG> double tee pointing up |
| <STRONG>Gd</STRONG> double tee pointing down |
| <STRONG>Gh</STRONG> double horizontal line |
| <STRONG>Gv</STRONG> double vertical line |
| <STRONG>Gc</STRONG> double intersection |
| <STRONG>GG</STRONG> ACS magic cookie count |
| |
| <STRONG>captoinfo</STRONG> composes single-line capabilities into an <STRONG>acsc</STRONG> string, and |
| discards <STRONG>GG</STRONG> and double-line capabilities with a warning diagnostic. |
| |
| IBM's AIX has a <EM>terminfo</EM> facility descended from SVr1 <EM>terminfo</EM>, but |
| which is incompatible with the SVr4 format. <STRONG>captoinfo</STRONG> translates the |
| following AIX extensions. |
| |
| <STRONG>IBM</STRONG> <STRONG>XSI</STRONG> |
| ------------- |
| ksel kslt |
| kbtab kcbt |
| font0 s0ds |
| font1 s1ds |
| font2 s2ds |
| font3 s3ds |
| |
| Additionally, this program translates the AIX <STRONG>box1</STRONG> capability to an |
| <STRONG>acsc</STRONG> string. |
| |
| The HP-UX <EM>terminfo</EM> library supports two nonstandard <EM>terminfo</EM> |
| capabilities, <STRONG>meml</STRONG> (memory lock) and <STRONG>memu</STRONG> (memory unlock). <STRONG>captoinfo</STRONG> |
| discards these with a warning message. |
| |
| |
| </PRE><H2><a name="h2-FILES">FILES</a></H2><PRE> |
| <EM>/etc/termcap</EM> |
| default <EM>termcap</EM> terminal capability database |
| |
| |
| </PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE> |
| X/Open Curses, Issue 7 (2009) describes <STRONG>tic</STRONG> briefly, but omits this |
| program. |
| |
| SVr4 systems provide <STRONG>captoinfo</STRONG> as a separate application from <STRONG>tic</STRONG>. Its |
| <STRONG>-v</STRONG> option does not accept a trace level argument <EM>n</EM>; repeat <STRONG>-v</STRONG> <EM>n</EM> times |
| instead. |
| |
| NetBSD does not provide this application. |
| |
| |
| </PRE><H2><a name="h2-AUTHORS">AUTHORS</a></H2><PRE> |
| Eric S. Raymond <esr@snark.thyrsus.com> and |
| Thomas E. Dickey <dickey@invisible-island.net> |
| |
| |
| </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE> |
| <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> |
| |
| |
| |
| ncurses 6.5 2024-03-23 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG> |
| </PRE> |
| <div class="nav"> |
| <ul> |
| <li><a href="#h2-NAME">NAME</a></li> |
| <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li> |
| <li><a href="#h2-DESCRIPTION">DESCRIPTION</a> |
| <ul> |
| <li><a href="#h3-Translations-from-Nonstandard-Capabilities">Translations from Nonstandard Capabilities</a></li> |
| </ul> |
| </li> |
| <li><a href="#h2-FILES">FILES</a></li> |
| <li><a href="#h2-PORTABILITY">PORTABILITY</a></li> |
| <li><a href="#h2-AUTHORS">AUTHORS</a></li> |
| <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li> |
| </ul> |
| </div> |
| </BODY> |
| </HTML> |