ncurses 5.9 - patch 20130309
[ncurses.git] / doc / html / man / captoinfo.1m.html
index 806aec57a10ad2e087d60e95a6a60571eb4635d9..3bd4ca552b5550a9f1333ed3def9479fd6472ee5 100644 (file)
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<!-- 
+  * t
+  ****************************************************************************
+  * Copyright (c) 1998-2007,2010 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.25 2010/12/04 18:36:44 tom Exp @
+-->
 <HTML>
+<HEAD>
+<TITLE>captoinfo 1m</TITLE>
+<link rev=made href="mailto:bug-ncurses@gnu.org">
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</HEAD>
 <BODY>
+<H1>captoinfo 1m</H1>
+<HR>
 <PRE>
 <!-- Manpage converted by man2html 3.0.1 -->
+<STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>                                             <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
+
+
+
 
 </PRE>
 <H2>NAME</H2><PRE>
-       <B>captoinfo</B>  - convert a <I>termcap</I> description into a <I>terminfo</I>
+       <STRONG>captoinfo</STRONG>  - convert a <EM>termcap</EM> description into a <EM>terminfo</EM>
        description
 
 
 </PRE>
 <H2>SYNOPSIS</H2><PRE>
-       <B>captoinfo</B> [<B>-v</B><I>n</I> <I>width</I>]  [<B>-V</B>] [<B>-1</B>] [<B>-w</B> <I>width</I>] <I>file</I> . . .
+       <STRONG>captoinfo</STRONG> [<STRONG>-v</STRONG><EM>n</EM> <EM>width</EM>]  [<STRONG>-V</STRONG>] [<STRONG>-1</STRONG>] [<STRONG>-w</STRONG> <EM>width</EM>] <EM>file</EM> . . .
 
 
 </PRE>
 <H2>DESCRIPTION</H2><PRE>
-       <B>captoinfo</B> looks in <I>file</I>  for  <B>termcap</B>  descriptions.   For
-       each  one  found,  an  equivalent  <B>terminfo</B> description is
-       written to standard output.  Termcap <B>tc</B>  capabilities  are
-       translated directly to terminfo <B>use</B> capabilities.
-
-       If no <I>file</I> is given, then the environment variable <B>TERMCAP</B>
-       is used for the filename or entry.  If <B>TERMCAP</B> is  a  full
-       pathname  to  a  file,  only  the  terminal  whose name is
-       specified in the environment variable  <B>TERM</B>  is  extracted
-       from  that  file.   If the environment variable <B>TERMCAP</B> is
-       not set, then the file <B>/usr/share/terminfo</B> is read.
-
-       <B>-v</B>   print out tracing information on  standard  error  as
+       <STRONG>captoinfo</STRONG> looks  in  each  given  text  <EM>file</EM>  for  <STRONG>termcap</STRONG>
+       descriptions.   For each one found, an equivalent <STRONG>terminfo</STRONG>
+       description is written to  standard  output.   Termcap  <STRONG>tc</STRONG>
+       capabilities are translated directly to terminfo <STRONG>use</STRONG> capa-
+       bilities.
+
+       If no <EM>file</EM> is given, then the environment variable <STRONG>TERMCAP</STRONG>
+       is  used  for the filename or entry.  If <STRONG>TERMCAP</STRONG> is a full
+       pathname to a file, only the terminal whose name is speci-
+       fied  in  the  environment variable <STRONG>TERM</STRONG> is extracted from
+       that file.  If the environment  variable  <STRONG>TERMCAP</STRONG>  is  not
+       set, then the file <STRONG>/usr/share/terminfo</STRONG> is read.
+
+       <STRONG>-v</STRONG>   print  out  tracing  information on standard error as
             the program runs.
 
-       <B>-V</B>   print  out  the  version  of  the  program  in use on
-            standard error and exit.
+       <STRONG>-V</STRONG>   print out the version of the program in use on  stan-
+            dard error and exit.
 
-       <B>-1</B>   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.
+       <STRONG>-1</STRONG>   cause  the fields to print out one to a line.  Other-
+            wise, the fields will be printed several to a line to
+            a maximum width of 60 characters.
 
-       <B>-w</B>   change the output to <I>width</I> characters.
+       <STRONG>-w</STRONG>   change the output to <EM>width</EM> characters.
 
 
 </PRE>
 <H2>FILES</H2><PRE>
-       /usr/share/terminfo Compiled     terminal      description
-                           database.
+       /usr/share/terminfo Compiled  terminal  description  data-
+                           base.
 
 
 </PRE>
 <H2>TRANSLATIONS FROM NONSTANDARD CAPABILITIES</H2><PRE>
-       Some  obsolete nonstandard capabilities will automatically
-       be translated into  standard  (SVr4/XSI  Curses)  terminfo
-       capabilities   by   <B>captoinfo</B>.    Whenever  one  of  these
-       automatic translations is done, the program will issue  an
+       Some obsolete nonstandard capabilities will  automatically
+       be  translated  into  standard  (SVr4/XSI Curses) terminfo
+       capabilities by <STRONG>captoinfo</STRONG>.  Whenever one  of  these  auto-
+       matic  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
+       has  not  mistakenly  translated  a completely unknown and
        random capability and/or syntax error.
 
        Nonstd   Std    From           Terminfo
        CV       ve     AT&amp;T    cursor_normal
        DS       mh     AT&amp;T    enter_dim_mode
        EE       me     AT&amp;T    exit_attribute_mode
-
        FE       LF     AT&amp;T    label_on
        FL       LO     AT&amp;T    label_off
        XS       mk     AT&amp;T    enter_secure_mode
        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
        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:
+       XENIX termcap also used to have a set of  extension  capa-
+       bilities  for forms drawing, designed to take advantage of
+       the IBM PC high-half graphics.  They were as follows:
 
        Cap          Graphic
        -----------------------------
        Gc    intersection
        GG    acs magic cookie count
 
-       If  the  single-line  capabilities occur in an entry, they
-       will automatically be composed into an <B>acsc</B>  string.   The
-       double-line  capabilities  and  <B>GG</B>  are  discarded  with a
-       warning message.
+       If the single-line capabilities occur in  an  entry,  they
+       will  automatically  be composed into an <EM>acsc</EM> string.  The
+       double-line capabilities and <STRONG>GG</STRONG> are discarded with a warn-
+       ing 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's AIX has a terminfo facility descended from SVr1 ter-
+       minfo but incompatible with the SVr4 format.  The  follow-
+       ing AIX extensions are automatically translated:
 
         IBM    XSI
        -------------
        font2   s2ds
        font3   s3ds
 
-       Additionally,   the   AIX   <B>box1</B>   capability   will    be
-       automatically translated to an <B>acsc</B> string.
+       Additionally,  the  AIX  <EM>box1</EM> capability will be automati-
+       cally translated to an <EM>acsc</EM> string.
 
-       Hewlett-Packard's    terminfo    library    supports   two
-       nonstandard terminfo capabilities <B>meml</B> (memory  lock)  and
-       <B>memu</B>  (memory  unlock).   These  will  be discarded with a
-       warning message.
+       Hewlett-Packard's terminfo library supports  two  nonstan-
+       dard  terminfo  capabilities  <EM>meml</EM>  (memory lock) and <EM>memu</EM>
+       (memory unlock).  These will be discarded with  a  warning
+       message.
 
 
 </PRE>
 <H2>NOTES</H2><PRE>
-       This utility is actually a link to <B><A HREF="tic.1m.html">tic(1m)</A></B>, running in  <I>-I</I>
-       mode.  You can use other <I>tic</I> options such as <B>-f</B> and  <B>-x</B>.
+       This  utility is actually a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, running in <EM>-I</EM>
+       mode.  You can use other <STRONG>tic</STRONG> options such as <STRONG>-f</STRONG> and  <STRONG>-x</STRONG>.
 
-       The  trace  option isn't identical to SVr4's.  Under SVr4,
-       instead of following the -v with  a  trace  level  n,  you
+       The trace option is not identical to SVr4's.  Under  SVr4,
+       instead  of  following  the  <STRONG>-v</STRONG>  with a trace level n, you
        repeat it n times.
 
 
 </PRE>
 <H2>SEE ALSO</H2><PRE>
-       <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B>, <B><A HREF="terminfo.5.html">terminfo(5)</A></B>
+       <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
+
+       This describes <STRONG>ncurses</STRONG> version 5.9 (patch 20130309).
 
 
 </PRE>
 <H2>AUTHOR</H2><PRE>
-       Eric S. Raymond &lt;esr@snark.thyrsus.com&gt;
-
-
-
-
-
-
-
-
-
-
-
-
+       Eric S. Raymond &lt;esr@snark.thyrsus.com&gt; and
+       Thomas E. Dickey &lt;dickey@invisible-island.net&gt;
 
 
 
+                                                          <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
 </PRE>
 <HR>
 <ADDRESS>