cffad9ec2c3afd78e4f824da9bb6c5ea41735467
[ncurses.git] / doc / html / man / infocmp.1m.html
1 <!-- 
2   * t
3   ****************************************************************************
4   * Copyright (c) 1998-2016,2017 Free Software Foundation, Inc.              *
5   *                                                                          *
6   * Permission is hereby granted, free of charge, to any person obtaining a  *
7   * copy of this software and associated documentation files (the            *
8   * "Software"), to deal in the Software without restriction, including      *
9   * without limitation the rights to use, copy, modify, merge, publish,      *
10   * distribute, distribute with modifications, sublicense, and/or sell       *
11   * copies of the Software, and to permit persons to whom the Software is    *
12   * furnished to do so, subject to the following conditions:                 *
13   *                                                                          *
14   * The above copyright notice and this permission notice shall be included  *
15   * in all copies or substantial portions of the Software.                   *
16   *                                                                          *
17   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
18   * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
19   * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
20   * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
21   * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
22   * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
23   * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
24   *                                                                          *
25   * Except as contained in this notice, the name(s) of the above copyright   *
26   * holders shall not be used in advertising or otherwise to promote the     *
27   * sale, use or other dealings in this Software without prior written       *
28   * authorization.                                                           *
29   ****************************************************************************
30   * @Id: infocmp.1m,v 1.60 2017/01/14 19:55:27 tom Exp @
31 -->
32 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
33 <HTML>
34 <HEAD>
35 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
36 <meta name="generator" content="Manpage converted by man2html - see http://invisible-island.net/scripts/readme.html#others_scripts">
37 <TITLE>infocmp 1m</TITLE>
38 <link rev=made href="mailto:bug-ncurses@gnu.org">
39 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
40 </HEAD>
41 <BODY>
42 <H1 class="no-header">infocmp 1m</H1>
43 <PRE>
44 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>                                                 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
45
46
47
48
49 </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
50        <STRONG>infocmp</STRONG> - compare or print out <EM>terminfo</EM> descriptions
51
52
53 </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
54        <STRONG>infocmp</STRONG> [<STRONG>-1CDEFGIKLTUVWcdegilnpqrtux</STRONG>]
55              [<STRONG>-v</STRONG> <EM>n</EM>] [<STRONG>-s</STRONG> <STRONG>d</STRONG>| <STRONG>i</STRONG>| <STRONG>l</STRONG>| <STRONG>c</STRONG>] [<STRONG>-Q</STRONG> <EM>n</EM>] [<STRONG>-R</STRONG> <STRONG>subset</STRONG>]
56              [<STRONG>-w</STRONG> <EM>width</EM>] [<STRONG>-A</STRONG> <EM>directory</EM>] [<STRONG>-B</STRONG> <EM>directory</EM>]
57              [<EM>termname</EM>...]
58
59
60 </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
61        <STRONG>infocmp</STRONG>  can  be  used  to compare a binary <STRONG>terminfo</STRONG> entry
62        with other terminfo entries, rewrite a  <STRONG>terminfo</STRONG>  descrip-
63        tion  to  take  advantage  of  the <STRONG>use=</STRONG> terminfo field, or
64        print out a <STRONG>terminfo</STRONG>  description  from  the  binary  file
65        (<STRONG>term</STRONG>) in a variety of formats.  In all cases, the boolean
66        fields will be printed  first,  followed  by  the  numeric
67        fields, followed by the string fields.
68
69
70 </PRE><H3><a name="h3-Default-Options">Default Options</a></H3><PRE>
71        If  no options are specified and zero or one <EM>termnames</EM> are
72        specified, the <STRONG>-I</STRONG> option will be assumed.   If  more  than
73        one <EM>termname</EM> is specified, the <STRONG>-d</STRONG> option will be assumed.
74
75
76 </PRE><H3><a name="h3-Comparison-Options-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></H3><PRE>
77        <STRONG>infocmp</STRONG>  compares  the  <STRONG>terminfo</STRONG>  description of the first
78        terminal <EM>termname</EM> with each of the descriptions  given  by
79        the  entries  for  the  other  terminal's <EM>termnames</EM>.  If a
80        capability is defined for only one of the  terminals,  the
81        value  returned will depend on the type of the capability:
82        <STRONG>F</STRONG> for boolean variables, <STRONG>-1</STRONG>  for  integer  variables,  and
83        <STRONG>NULL</STRONG> for string variables.
84
85        The  <STRONG>-d</STRONG>  option produces a list of each capability that is
86        different between two entries.  This option is  useful  to
87        show  the  difference between two entries, created by dif-
88        ferent people, for the same or similar terminals.
89
90        The <STRONG>-c</STRONG> option produces a list of each capability  that  is
91        common between two or more entries.  Capabilities that are
92        not set are ignored.  This option can be used as  a  quick
93        check to see if the <STRONG>-u</STRONG> option is worth using.
94
95        The  <STRONG>-n</STRONG>  option produces a list of each capability that is
96        in none of the given entries.  If no <EM>termnames</EM> are  given,
97        the environment variable <STRONG>TERM</STRONG> will be used for both of the
98        <EM>termnames</EM>.  This can be used as a quick check  to  see  if
99        anything was left out of a description.
100
101
102 </PRE><H3><a name="h3-Source-Listing-Options-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></H3><PRE>
103        The  <STRONG>-I</STRONG>,  <STRONG>-L</STRONG>, and <STRONG>-C</STRONG> options will produce a source listing
104        for each terminal named.
105
106       <STRONG>-I</STRONG>   use the <STRONG>terminfo</STRONG> names
107       <STRONG>-L</STRONG>   use the long C variable name listed in &lt;<STRONG>term.h</STRONG>&gt;
108       <STRONG>-C</STRONG>   use the <STRONG>termcap</STRONG> names
109       <STRONG>-r</STRONG>   when using <STRONG>-C</STRONG>, put out all capabilities in <STRONG>termcap</STRONG> form
110       <STRONG>-K</STRONG>   modifies the <STRONG>-C</STRONG> option, improving BSD-compatibility.
111
112        If no <EM>termnames</EM> are given, the environment  variable  <STRONG>TERM</STRONG>
113        will be used for the terminal name.
114
115        The  source produced by the <STRONG>-C</STRONG> option may be used directly
116        as a <STRONG>termcap</STRONG> entry, but not all parameterized strings  can
117        be changed to the <STRONG>termcap</STRONG> format.  <STRONG>infocmp</STRONG> will attempt to
118        convert most of the parameterized  information,  and  any-
119        thing  not  converted will be plainly marked in the output
120        and commented out.  These should be edited by hand.
121
122        For best results when converting to  <STRONG>termcap</STRONG>  format,  you
123        should use both <STRONG>-C</STRONG> and <STRONG>-r</STRONG>.  Normally a termcap description
124        is limited to 1023 bytes.  <STRONG>infocmp</STRONG> trims away less  essen-
125        tial  parts  to make it fit.  If you are converting to one
126        of the (rare)  termcap  implementations  which  accept  an
127        unlimited  size  of  termcap,  you  may want to add the <STRONG>-T</STRONG>
128        option.  More often however, you  must  help  the  termcap
129        implementation,  and  trim  excess  whitespace (use the <STRONG>-0</STRONG>
130        option for that).
131
132        All padding information  for  strings  will  be  collected
133        together  and  placed at the beginning of the string where
134        <STRONG>termcap</STRONG> expects it.  Mandatory padding  (padding  informa-
135        tion with a trailing '/') will become optional.
136
137        All <STRONG>termcap</STRONG> variables no longer supported by <STRONG>terminfo</STRONG>, but
138        which are derivable from other <STRONG>terminfo</STRONG> variables, will be
139        output.  Not all <STRONG>terminfo</STRONG> capabilities will be translated;
140        only those variables which were part of <STRONG>termcap</STRONG> will  nor-
141        mally  be  output.  Specifying the <STRONG>-r</STRONG> option will take off
142        this restriction, allowing all capabilities to  be  output
143        in  <EM>termcap</EM>  form.  Normally you would use both the <STRONG>-C</STRONG> and
144        <STRONG>-r</STRONG> options.  The  actual  format  used  incorporates  some
145        improvements  for escaped characters from terminfo format.
146        For a stricter  BSD-compatible  translation,  use  the  <STRONG>-K</STRONG>
147        option rather than <STRONG>-C</STRONG>.
148
149        Note that because padding is collected to the beginning of
150        the capability, not all capabilities are  output.   Manda-
151        tory  padding  is  not supported.  Because <STRONG>termcap</STRONG> strings
152        are not as flexible, it is not always possible to  convert
153        a  <STRONG>terminfo</STRONG>  string  capability into an equivalent <STRONG>termcap</STRONG>
154        format.  A subsequent conversion of the <STRONG>termcap</STRONG> file  back
155        into  <STRONG>terminfo</STRONG>  format  will not necessarily reproduce the
156        original <STRONG>terminfo</STRONG> source.
157
158        Some common <STRONG>terminfo</STRONG> parameter  sequences,  their  <STRONG>termcap</STRONG>
159        equivalents,  and  some terminal types which commonly have
160        such sequences, are:
161
162      <STRONG>terminfo</STRONG>                    <STRONG>termcap</STRONG>   Representative Terminals
163      ---------------------------------------------------------------
164      <STRONG>%p1%c</STRONG>                       <STRONG>%.</STRONG>        adm
165      <STRONG>%p1%d</STRONG>                       <STRONG>%d</STRONG>        hp, ANSI standard, vt100
166      <STRONG>%p1%'x'%+%c</STRONG>                 <STRONG>%+x</STRONG>       concept
167      <STRONG>%i</STRONG>                          <STRONG>%i</STRONG>q       ANSI standard, vt100
168      <STRONG>%p1%?%'x'%&gt;%t%p1%'y'%+%;</STRONG>    <STRONG>%&gt;xy</STRONG>      concept
169      <STRONG>%p2</STRONG> is printed before <STRONG>%p1</STRONG>   <STRONG>%r</STRONG>        hp
170
171
172 </PRE><H3><a name="h3-Use_-Option-_-u_">Use= Option [-u]</a></H3><PRE>
173        The <STRONG>-u</STRONG> option produces a <STRONG>terminfo</STRONG>  source  description  of
174        the  first  terminal <EM>termname</EM> which is relative to the sum
175        of the descriptions given by the  entries  for  the  other
176        terminals  <EM>termnames</EM>.   It does this by analyzing the dif-
177        ferences  between  the  first  <EM>termname</EM>  and   the   other
178        <EM>termnames</EM> and producing a description with <STRONG>use=</STRONG> fields for
179        the other terminals.  In this manner, it  is  possible  to
180        retrofit   generic  terminfo  entries  into  a  terminal's
181        description.  Or, if two similar terminals exist, but were
182        coded  at  different  times or by different people so that
183        each description is a full description, using <STRONG>infocmp</STRONG> will
184        show what can be done to change one description to be rel-
185        ative to the other.
186
187        A capability will get printed with an at-sign (@) if it no
188        longer  exists in the first <EM>termname</EM>, but one of the other
189        <EM>termname</EM> entries contains a value for it.  A  capability's
190        value  gets  printed if the value in the first <EM>termname</EM> is
191        not found in any of the other <EM>termname</EM> entries, or if  the
192        first of the other <EM>termname</EM> entries that has this capabil-
193        ity gives a different value for the capability  than  that
194        in the first <EM>termname</EM>.
195
196        The  order  of  the other <EM>termname</EM> entries is significant.
197        Since the terminfo compiler <STRONG>tic</STRONG> does a left-to-right  scan
198        of the capabilities, specifying two <STRONG>use=</STRONG> entries that con-
199        tain differing entries for the same capabilities will pro-
200        duce  different  results  depending  on the order that the
201        entries are given in.  <STRONG>infocmp</STRONG> will flag any  such  incon-
202        sistencies  between the other <EM>termname</EM> entries as they are
203        found.
204
205        Alternatively, specifying a capability <EM>after</EM> a <STRONG>use=</STRONG>  entry
206        that contains that capability will cause the second speci-
207        fication to be  ignored.   Using  <STRONG>infocmp</STRONG>  to  recreate  a
208        description can be a useful check to make sure that every-
209        thing was  specified  correctly  in  the  original  source
210        description.
211
212        Another  error  that  does  not  cause  incorrect compiled
213        files, but will slow down the compilation time, is  speci-
214        fying  extra  <STRONG>use=</STRONG>  fields  that are superfluous.  <STRONG>infocmp</STRONG>
215        will flag any other <EM>termname</EM> <EM>use=</EM>  fields  that  were  not
216        needed.
217
218    <STRONG>Changing</STRONG> <STRONG>Databases</STRONG> <STRONG>[-A</STRONG> <EM>directory</EM>] [-B <EM>directory</EM>]
219        Like other <STRONG>ncurses</STRONG> utilities, <STRONG>infocmp</STRONG> looks for the termi-
220        nal descriptions in several places.  You can use the  <STRONG>TER-</STRONG>
221        <STRONG>MINFO</STRONG>  and <STRONG>TERMINFO_DIRS</STRONG> environment variables to override
222        the compiled-in default list  of  places  to  search  (see
223        <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> for details).
224
225        You  can  also  use  the options <STRONG>-A</STRONG> and <STRONG>-B</STRONG> to override the
226        list of places to search when comparing terminal  descrip-
227        tions:
228
229        <STRONG>o</STRONG>   The <STRONG>-A</STRONG> option sets the location for the first <EM>termname</EM>
230
231        <STRONG>o</STRONG>   The   <STRONG>-B</STRONG>  option  sets  the  location  for  the  other
232            <EM>termnames</EM>.
233
234        Using these options, it is possible  to  compare  descrip-
235        tions  for  a  terminal  with the same name located in two
236        different databases.  For instance, you can use this  fea-
237        ture for comparing descriptions for the same terminal cre-
238        ated by different people.
239
240
241 </PRE><H3><a name="h3-Other-Options">Other Options</a></H3><PRE>
242        <STRONG>-0</STRONG>   causes the fields to be printed on one line,  without
243             wrapping.
244
245        <STRONG>-1</STRONG>   causes  the  fields  to be printed out one to a line.
246             Otherwise, the fields will be printed  several  to  a
247             line to a maximum width of 60 characters.
248
249        <STRONG>-a</STRONG>   tells  <STRONG>infocmp</STRONG>  to  retain commented-out capabilities
250             rather than discarding them.  Capabilities  are  com-
251             mented by prefixing them with a period.
252
253        <STRONG>-D</STRONG>   tells <STRONG>infocmp</STRONG> to print the database locations that it
254             knows about, and exit.
255
256        <STRONG>-E</STRONG>   Dump  the  capabilities  of  the  given  terminal  as
257             tables,  needed  in  the C initializer for a TERMTYPE
258             structure (the terminal capability structure  in  the
259             <STRONG>&lt;term.h&gt;</STRONG>).   This option is useful for preparing ver-
260             sions of the curses library  hardwired  for  a  given
261             terminal  type.   The tables are all declared static,
262             and are named according to the type and the  name  of
263             the corresponding terminal entry.
264
265             Before  ncurses  5.0, the split between the <STRONG>-e</STRONG> and <STRONG>-E</STRONG>
266             options was not  needed;  but  support  for  extended
267             names required making the arrays of terminal capabil-
268             ities separate from the TERMTYPE structure.
269
270        <STRONG>-e</STRONG>   Dump the capabilities of the given terminal  as  a  C
271             initializer  for  a  TERMTYPE structure (the terminal
272             capability structure in the <STRONG>&lt;term.h&gt;</STRONG>).   This  option
273             is  useful  for  preparing  versions  of  the  curses
274             library hardwired for a given terminal type.
275
276        <STRONG>-F</STRONG>   compare terminfo files.  This assumes that  two  fol-
277             lowing   arguments  are  filenames.   The  files  are
278             searched for pairwise matches between  entries,  with
279             two entries considered to match if any of their names
280             do.  The report  printed  to  standard  output  lists
281             entries  with  no  matches  in  the  other  file, and
282             entries with more than one match.  For  entries  with
283             exactly  one  match  it includes a difference report.
284             Normally, to reduce the volume  of  the  report,  use
285             references  are  not resolved before looking for dif-
286             ferences, but resolution can be forced by also speci-
287             fying <STRONG>-r</STRONG>.
288
289        <STRONG>-f</STRONG>   Display   complex   terminfo  strings  which  contain
290             if/then/else/endif expressions indented for readabil-
291             ity.
292
293        <STRONG>-G</STRONG>   Display constant literals in decimal form rather than
294             their character equivalents.
295
296        <STRONG>-g</STRONG>   Display constant character literals  in  quoted  form
297             rather than their decimal equivalents.
298
299        <STRONG>-i</STRONG>   Analyze the initialization (<STRONG>is1</STRONG>, <STRONG>is2</STRONG>, <STRONG>is3</STRONG>), and reset
300             (<STRONG>rs1</STRONG>, <STRONG>rs2</STRONG>, <STRONG>rs3</STRONG>), strings in the  entry,  as  well  as
301             those  used  for starting/stopping cursor-positioning
302             mode (<STRONG>smcup</STRONG>,  <STRONG>rmcup</STRONG>)  as  well  as  starting/stopping
303             keymap mode (<STRONG>smkx</STRONG>, <STRONG>rmkx</STRONG>).
304
305             For  each  string,  the code tries to analyze it into
306             actions in terms of the  other  capabilities  in  the
307             entry,  certain  X3.64/ISO 6429/ECMA-48 capabilities,
308             and certain DEC VT-series private modes (the  set  of
309             recognized  special  sequences  has been selected for
310             completeness over the  existing  terminfo  database).
311             Each  report  line  consists  of the capability name,
312             followed by a colon and space, followed by  a  print-
313             able expansion of the capability string with sections
314             matching recognized actions translated into {}-brack-
315             eted descriptions.
316
317             Here is a list of the DEC/ANSI special sequences rec-
318             ognized:
319
320                   Action        Meaning
321                   -----------------------------------------
322                   RIS           full reset
323                   SC            save cursor
324                   RC            restore cursor
325                   LL            home-down
326                   RSR           reset scroll region
327                   -----------------------------------------
328                   DECSTR        soft reset (VT320)
329                   S7C1T         7-bit controls (VT220)
330                   -----------------------------------------
331                   ISO DEC G0    enable DEC graphics for G0
332                   ISO UK G0     enable UK chars for G0
333                   ISO US G0     enable US chars for G0
334                   ISO DEC G1    enable DEC graphics for G1
335                   ISO UK G1     enable UK chars for G1
336                   ISO US G1     enable US chars for G1
337                   -----------------------------------------
338                   DECPAM        application keypad mode
339                   DECPNM        normal keypad mode
340                   DECANSI       enter ANSI mode
341                   -----------------------------------------
342                   ECMA[+-]AM    keyboard action mode
343                   ECMA[+-]IRM   insert replace mode
344                   ECMA[+-]SRM   send receive mode
345                   ECMA[+-]LNM   linefeed mode
346                   -----------------------------------------
347                   DEC[+-]CKM    application cursor keys
348                   DEC[+-]ANM    set VT52 mode
349                   DEC[+-]COLM   132-column mode
350                   DEC[+-]SCLM   smooth scroll
351                   DEC[+-]SCNM   reverse video mode
352                   DEC[+-]OM     origin mode
353                   DEC[+-]AWM    wraparound mode
354                   DEC[+-]ARM    auto-repeat mode
355
356             It also recognizes  a  SGR  action  corresponding  to
357             ANSI/ISO  6429/ECMA  Set Graphics Rendition, with the
358             values NORMAL, BOLD, UNDERLINE, BLINK,  and  REVERSE.
359             All  but NORMAL may be prefixed with `+' (turn on) or
360             `-' (turn off).
361
362             An  SGR0  designates  an  empty  highlight   sequence
363             (equivalent to {SGR:NORMAL}).
364
365        <STRONG>-l</STRONG>   Set output format to terminfo.
366
367        <STRONG>-p</STRONG>   Ignore padding specifications when comparing strings.
368
369        <STRONG>-Q</STRONG> <EM>n</EM> Rather  than  show  source in terminfo (text) format,
370             print the compiled (binary) format in hexadecimal  or
371             base64 form, depending on the option's value:
372
373                1  hexadecimal
374
375                2  base64
376
377                3  hexadecimal and base64
378
379        <STRONG>-q</STRONG>   This makes the output a little shorter:
380
381             <STRONG>o</STRONG>   Make  the  comparison listing shorter by omitting
382                 subheadings, and using "-" for  absent  capabili-
383                 ties, "@" for canceled rather than "NULL".
384
385             <STRONG>o</STRONG>   Omit  the "Reconstructed from" comment for source
386                 listings.
387
388        <STRONG>-R</STRONG><EM>subset</EM>
389             Restrict output to a given subset.   This  option  is
390             for  use with archaic versions of terminfo like those
391             on SVr1, Ultrix, or HP/UX that  do  not  support  the
392             full  set  of  SVR4/XSI Curses terminfo; and variants
393             such as AIX that have their own extensions incompati-
394             ble with SVr4/XSI.
395
396             Available  terminfo  subsets  are  "SVr1",  "Ultrix",
397             "HP", and "AIX"; see <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>  for  details.   You
398             can  also  choose the subset "BSD" which selects only
399             capabilities with termcap equivalents  recognized  by
400             4.4BSD.
401
402        <STRONG>-s</STRONG> <EM>[d|i|l|c]</EM>
403             The  <STRONG>-s</STRONG>  option  sorts  the  fields  within each type
404             according to the argument below:
405
406             <STRONG>d</STRONG>    leave fields in the order that they  are  stored
407                  in the <EM>terminfo</EM> database.
408
409             <STRONG>i</STRONG>    sort by <EM>terminfo</EM> name.
410
411             <STRONG>l</STRONG>    sort by the long C variable name.
412
413             <STRONG>c</STRONG>    sort by the <EM>termcap</EM> name.
414
415             If the <STRONG>-s</STRONG> option is not given, the fields printed out
416             will be sorted alphabetically by  the  <STRONG>terminfo</STRONG>  name
417             within each type, except in the case of the <STRONG>-C</STRONG> or the
418             <STRONG>-L</STRONG> options, which cause the sorting to be done by the
419             <STRONG>termcap</STRONG>  name  or  the  long C variable name, respec-
420             tively.
421
422        <STRONG>-T</STRONG>   eliminates size-restrictions on the  generated  text.
423             This is mainly useful for testing and analysis, since
424             the compiled descriptions are limited (e.g., 1023 for
425             termcap, 4096 for terminfo).
426
427        <STRONG>-t</STRONG>   tells  <STRONG>tic</STRONG>  to  discard  commented-out  capabilities.
428             Normally when translating from terminfo  to  termcap,
429             untranslatable capabilities are commented-out.
430
431        <STRONG>-U</STRONG>   tells  <STRONG>infocmp</STRONG>  to  not  post-process  the data after
432             parsing the source file.   This  feature  helps  when
433             comparing  the  actual  contents of two source files,
434             since it excludes the inferences that  <STRONG>infocmp</STRONG>  makes
435             to fill in missing data.
436
437        <STRONG>-V</STRONG>   reports the version of ncurses which was used in this
438             program, and exits.
439
440        <STRONG>-v</STRONG> <EM>n</EM> prints out tracing information on standard  error  as
441             the program runs.
442
443             The  optional  parameter  <EM>n</EM> is a number from 1 to 10,
444             inclusive, indicating the desired level of detail  of
445             information.   If  ncurses  is  built without tracing
446             support, the optional parameter is ignored.
447
448        <STRONG>-W</STRONG>   By itself, the <STRONG>-w</STRONG> option will not force long  strings
449             to be wrapped.  Use the <STRONG>-W</STRONG> option to do this.
450
451        <STRONG>-w</STRONG> <EM>width</EM>
452             changes the output to <EM>width</EM> characters.
453
454        <STRONG>-x</STRONG>   print   information  for  user-defined  capabilities.
455             These are extensions to the terminfo repertoire which
456             can be loaded using the <STRONG>-x</STRONG> option of <STRONG>tic</STRONG>.
457
458
459 </PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
460        /usr/share/terminfo Compiled  terminal  description  data-
461                            base.
462
463
464 </PRE><H2><a name="h2-EXTENSIONS">EXTENSIONS</a></H2><PRE>
465        The <STRONG>-0</STRONG>, <STRONG>-1</STRONG>, <STRONG>-E</STRONG>, <STRONG>-F</STRONG>, <STRONG>-G</STRONG>, <STRONG>-R</STRONG>, <STRONG>-T</STRONG>, <STRONG>-V</STRONG>, <STRONG>-a</STRONG>, <STRONG>-e</STRONG>,  <STRONG>-f</STRONG>,  <STRONG>-g</STRONG>,  <STRONG>-i</STRONG>,
466        <STRONG>-l</STRONG>,  <STRONG>-p</STRONG>,  <STRONG>-q</STRONG>  and  <STRONG>-t</STRONG>  options  are  not supported in SVr4
467        curses.
468
469        The <STRONG>-r</STRONG> option's notion of `termcap' capabilities is System
470        V  Release  4's.   Actual  BSD curses versions will have a
471        more restricted set.  To see only the 4.4BSD set,  use  <STRONG>-r</STRONG>
472        <STRONG>-RBSD</STRONG>.
473
474
475 </PRE><H2><a name="h2-BUGS">BUGS</a></H2><PRE>
476        The <STRONG>-F</STRONG> option of <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG> should be a <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG> mode.
477
478
479 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
480        <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>,     <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>,     <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>,    <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>,
481        <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
482
483        http://invisible-island.net/ncurses/tctest.html
484
485        This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20170121).
486
487
488 </PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
489        Eric S. Raymond &lt;esr@snark.thyrsus.com&gt; and
490        Thomas E. Dickey &lt;dickey@invisible-island.net&gt;
491
492
493
494                                                             <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
495 </PRE>
496 <div class="nav">
497 <ul>
498 <li><a href="#h2-NAME">NAME</a></li>
499 <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
500 <li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
501 <ul>
502 <li><a href="#h3-Default-Options">Default Options</a></li>
503 <li><a href="#h3-Comparison-Options-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></li>
504 <li><a href="#h3-Source-Listing-Options-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></li>
505 <li><a href="#h3-Use_-Option-_-u_">Use= Option [-u]</a></li>
506 <li><a href="#h3-Other-Options">Other Options</a></li>
507 </ul>
508 </li>
509 <li><a href="#h2-FILES">FILES</a></li>
510 <li><a href="#h2-EXTENSIONS">EXTENSIONS</a></li>
511 <li><a href="#h2-BUGS">BUGS</a></li>
512 <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
513 <li><a href="#h2-AUTHOR">AUTHOR</a></li>
514 </ul>
515 </div>
516 </BODY>
517 </HTML>