ncurses 6.2 - patch 20210220
[ncurses.git] / man / infocmp.1m
1 '\" t
2 .\"***************************************************************************
3 .\" Copyright 2018-2019,2020 Thomas E. Dickey                                *
4 .\" Copyright 1998-2017,2018 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 .\"
31 .\" $Id: infocmp.1m,v 1.77 2020/07/25 20:37:39 tom Exp $
32 .TH @INFOCMP@ 1M ""
33 .ie \n(.g .ds `` \(lq
34 .el       .ds `` ``
35 .ie \n(.g .ds '' \(rq
36 .el       .ds '' ''
37 .ds n 5
38 .de bP
39 .ie n  .IP \(bu 4
40 .el    .IP \(bu 2
41 ..
42 .de NS
43 .ie n  .sp
44 .el    .sp .5
45 .ie n  .in +4
46 .el    .in +2
47 .nf
48 .ft C                   \" Courier
49 ..
50 .de NE
51 .fi
52 .ft R
53 .ie n  .in -4
54 .el    .in -2
55 ..
56 .ds d @TERMINFO@
57 .SH NAME
58 \fB@INFOCMP@\fR \- compare or print out \fIterminfo\fR descriptions
59 .SH SYNOPSIS
60 \fB@INFOCMP@\fR [\fB\-\
61 1\
62 C\
63 D\
64 E\
65 F\
66 G\
67 I\
68 K\
69 L\
70 T\
71 U\
72 V\
73 W\
74 c\
75 d\
76 e\
77 g\
78 i\
79 l\
80 n\
81 p\
82 q\
83 r\
84 t\
85 u\
86 x\
87 \fR]
88 .br
89       [\fB\-v\fR \fIn\fR] [\fB\-s d\fR| \fBi\fR| \fBl\fR| \fBc\fR] [\fB\-Q\fR \fIn\fR] [\fB\-R \fR\fBsubset\fR]
90 .br
91       [\fB\-w\fR\ \fIwidth\fR] [\fB\-A\fR\ \fIdirectory\fR] [\fB\-B\fR\ \fIdirectory\fR]
92 .br
93       [\fItermname\fR...]
94 .SH DESCRIPTION
95 \fB@INFOCMP@\fR can be used to compare a binary \fBterminfo\fR entry with other
96 terminfo entries, rewrite a \fBterminfo\fR description to take advantage of the
97 \fBuse=\fR terminfo field, or print out a \fBterminfo\fR description from the
98 binary file (\fBterm\fR) in a variety of formats.
99 In all cases, the boolean
100 fields will be printed first, followed by the numeric fields, followed by the
101 string fields.
102 .SS Default Options
103 If no options are specified and zero or one \fItermnames\fR are specified, the
104 \fB\-I\fR option will be assumed.
105 If more than one \fItermname\fR is specified,
106 the \fB\-d\fR option will be assumed.
107 .SS Comparison Options [\-d] [\-c] [\-n]
108 \fB@INFOCMP@\fR compares the \fBterminfo\fR description of the first terminal
109 \fItermname\fR with each of the descriptions given by the entries for the other
110 terminal's \fItermnames\fR.
111 If a capability is defined for only one of the
112 terminals, the value returned depends on the type of the capability:
113 .bP
114 \fBF\fR for missing boolean variables
115 .bP
116 \fBNULL\fR for missing integer or string variables
117 .PP
118 Use the \fB\-q\fP option to show the distinction between
119 \fIabsent\fP and \fIcancelled\fP capabilities.
120 .PP
121 These options produce a list which you can use to compare two
122 or more terminal descriptions:
123 .TP 5
124 \fB\-d\fR
125 produces a list of each capability that is \fIdifferent\fP
126 between two entries.
127 Each item in the list shows \*(``:\*('' after the capability name,
128 followed by the capability values, separated by a comma.
129 .TP
130 \fB\-c\fR
131 produces a list of each capability that is \fIcommon\fP between
132 two or more entries.
133 Missing capabilities are ignored.
134 Each item in the list shows \*(``=\*('' after the capability name,
135 followed by the capability value.
136 .IP
137 The \fB\-u\fR option provides a related output,
138 showing the first terminal description rewritten to use the second
139 as a building block via the \*(``use=\*('' clause.
140 .TP
141 \fB\-n\fR
142 produces a list of each capability that is in \fInone\fP of the given entries.
143 Each item in the list shows \*(``!\*('' before the capability name.
144 .IP
145 Normally only the conventional capabilities are shown.
146 Use the \fB\-x\fP option to add the BSD-compatibility
147 capabilities (names prefixed with \*(``OT\*('').
148 .IP
149 If no \fItermnames\fR are given,
150 \fB@INFOCMP@\fR uses the environment variable \fBTERM\fR
151 for each of the \fItermnames\fR.
152 .SS Source Listing Options [\-I] [\-L] [\-C] [\-r]
153 The \fB\-I\fR, \fB\-L\fR, and \fB\-C\fR options will produce
154 a source listing for each terminal named.
155 .
156 .TS
157 center tab(/) ;
158 l l .
159 \fB\-I\fR/use the \fBterminfo\fR names
160 \fB\-L\fR/use the long C variable name listed in <\fBterm.h\fR>
161 \fB\-C\fR/use the \fBtermcap\fR names
162 \fB\-r\fR/when using \fB\-C\fR, put out all capabilities in \fBtermcap\fR form
163 \fB\-K\fR/modifies the \fB\-C\fP option, improving BSD-compatibility.
164 .TE
165 .PP
166 If no \fItermnames\fR are given, the environment variable \fBTERM\fR will be
167 used for the terminal name.
168 .PP
169 The source produced by the \fB\-C\fR option may be used directly as a
170 \fBtermcap\fR entry, but not all parameterized strings can be changed to
171 the \fBtermcap\fR format.
172 \fB@INFOCMP@\fR will attempt to convert most of the
173 parameterized information, and anything not converted will be plainly marked in
174 the output and commented out.
175 These should be edited by hand.
176 .PP
177 For best results when converting to \fBtermcap\fP format,
178 you should use both \fB\-C\fP and \fB\-r\fP.
179 Normally a termcap description is limited to 1023 bytes.
180 \fB@INFOCMP@\fP trims away less essential parts to make it fit.
181 If you are converting to one of the (rare) termcap implementations
182 which accept an unlimited size of termcap,
183 you may want to add the \fB\-T\fP option.
184 More often however, you must help the termcap implementation,
185 and trim excess whitespace (use the \fB\-0\fP option for that).
186 .PP
187 All padding information for strings will be collected together and placed
188 at the beginning of the string where \fBtermcap\fR expects it.
189 Mandatory
190 padding (padding information with a trailing \*(``/\*('') will become optional.
191 .PP
192 All \fBtermcap\fR variables no longer supported by \fBterminfo\fR, but which
193 are derivable from other \fBterminfo\fR variables, will be output.
194 Not all
195 \fBterminfo\fR capabilities will be translated; only those variables which were
196 part of \fBtermcap\fR will normally be output.
197 Specifying the \fB\-r\fR option
198 will take off this restriction, allowing all capabilities to be output in
199 \fItermcap\fR form.
200 Normally you would use both the \fB\-C\fP and \fB\-r\fP options.
201 The actual format used incorporates some improvements for escaped characters
202 from terminfo format.
203 For a stricter BSD-compatible translation, use the \fB\-K\fR option
204 rather than \fB\-C\fP.
205 .PP
206 Note that because padding is collected to the beginning of the capability, not
207 all capabilities are output.
208 Mandatory padding is not supported.
209 Because
210 \fBtermcap\fR strings are not as flexible, it is not always possible to convert
211 a \fBterminfo\fR string capability into an equivalent \fBtermcap\fR format.
212 A subsequent conversion of the \fBtermcap\fR file
213 back into \fBterminfo\fR format
214 will not necessarily reproduce the original \fBterminfo\fR source.
215 .PP
216 Some common \fBterminfo\fR parameter sequences, their \fBtermcap\fR
217 equivalents, and some terminal types which commonly have such sequences, are:
218 .
219 .TS
220 center tab(/) ;
221 l c l
222 l l l.
223 \fBterminfo/termcap\fR/Representative Terminals
224 =
225 \fB%p1%c/%.\fR/adm
226 \fB%p1%d/%d\fR/hp, ANSI standard, vt100
227 \fB%p1%'x'%+%c/%+x\fR/concept
228 \fB%i/%i\fRq/ANSI standard, vt100
229 \fB%p1%?%'x'%>%t%p1%'y'%+%;/%>xy\fR/concept
230 \fB%p2\fR is printed before \fB%p1/%r\fR/hp
231 .TE
232 .SS Use= Option [\-u]
233 The \fB\-u\fR option produces a \fBterminfo\fR source description of the first
234 terminal \fItermname\fR which is relative to the sum of the descriptions given
235 by the entries for the other terminals \fItermnames\fR.
236 It does this by
237 analyzing the differences between the first \fItermname\fR and the other
238 \fItermnames\fR and producing a description with \fBuse=\fR fields for the
239 other terminals.
240 In this manner, it is possible to retrofit generic terminfo
241 entries into a terminal's description.
242 Or, if two similar terminals exist, but
243 were coded at different times or by different people so that each description
244 is a full description, using \fB@INFOCMP@\fR
245 will show what can be done to change
246 one description to be relative to the other.
247 .PP
248 A capability will be printed with an at-sign (@) if it no longer exists in the
249 first \fItermname\fR, but one of the other \fItermname\fR entries contains a
250 value for it.
251 A capability's value will be printed if the value in the first
252 \fItermname\fR is not found in any of the other \fItermname\fR entries, or if
253 the first of the other \fItermname\fR entries that has this capability gives a
254 different value for the capability than that in the first \fItermname\fR.
255 .PP
256 The order of the other \fItermname\fR entries is significant.
257 Since the
258 terminfo compiler \fB@TIC@\fR does a left-to-right scan of the capabilities,
259 specifying two \fBuse=\fR entries that contain differing entries for the same
260 capabilities will produce different results depending on the order that the
261 entries are given in.
262 \fB@INFOCMP@\fR will flag any such inconsistencies between
263 the other \fItermname\fR entries as they are found.
264 .PP
265 Alternatively, specifying a capability \fIafter\fR a \fBuse=\fR entry that
266 contains that capability will cause the second specification to be ignored.
267 Using \fB@INFOCMP@\fR to recreate a description can be a useful check to make
268 sure that everything was specified correctly in the original source
269 description.
270 .PP
271 Another error that does not cause incorrect compiled files, but will slow down
272 the compilation time, is specifying extra \fBuse=\fR fields that are
273 superfluous.
274 \fB@INFOCMP@\fR will flag any other \fItermname use=\fR fields that
275 were not needed.
276 .SS Changing Databases [\-A \fIdirectory\fR] [\-B \fIdirectory\fR]
277 Like other \fBncurses\fP utilities,
278 \fB@INFOCMP@\fP looks for the terminal descriptions in several places.
279 You can use the \fBTERMINFO\fP and \fBTERMINFO_DIRS\fP environment variables
280 to override the compiled-in default list of places to search
281 (see \fBcurses\fP(3X) for details).
282 .PP
283 You can also use the options \fB\-A\fR
284 and \fB\-B\fR to override the list of places to search
285 when comparing terminal descriptions:
286 .bP
287 The \fB\-A\fR option sets the location for the first \fItermname\fR
288 .bP
289 The \fB\-B\fR option sets the location for the other \fItermnames\fR.
290 .PP
291 Using these options, it is possible to
292 compare descriptions for a terminal with the same name located in two different
293 databases.
294 For instance,
295 you can use this feature for comparing descriptions for the same terminal
296 created by different people.
297 .SS Other Options
298 .TP 5
299 \fB\-0\fR
300 causes the fields to be printed on one line, without wrapping.
301 .TP 5
302 \fB\-1\fR
303 causes the fields to be printed out one to a line.
304 Otherwise,
305 the fields will be printed several to a line to a maximum width
306 of 60 characters.
307 .TP
308 \fB\-a\fR
309 tells \fB@INFOCMP@\fP to retain commented-out capabilities
310 rather than discarding them.
311 Capabilities are commented by prefixing them with a period.
312 .TP
313 \fB\-D\fR
314 tells \fB@INFOCMP@\fP to print the database locations that it knows about,
315 and exit.
316 .TP 5
317 \fB\-E\fR
318 Dump the capabilities of the given terminal as tables, needed in
319 the C initializer for a
320 TERMTYPE structure (the terminal capability structure in the \fB<term.h>\fR).
321 This option is useful for preparing versions of the curses library hardwired
322 for a given terminal type.
323 The tables are all declared static, and are named according to the type
324 and the name of the corresponding terminal entry.
325 .sp
326 Before ncurses 5.0, the split between the \fB\-e\fP and \fB\-E\fP
327 options was not needed; but support for extended names required making
328 the arrays of terminal capabilities separate from the TERMTYPE structure.
329 .TP 5
330 \fB\-e\fR
331 Dump the capabilities of the given terminal as a C initializer for a
332 TERMTYPE structure (the terminal capability structure in the \fB<term.h>\fR).
333 This option is useful for preparing versions of the curses library hardwired
334 for a given terminal type.
335 .TP 5
336 \fB\-F\fR
337 compare terminfo files.
338 This assumes that two following arguments are filenames.
339 The files are searched for pairwise matches between
340 entries, with two entries considered to match if any of their names do.
341 The report printed to standard output lists entries with no matches in
342 the other file, and entries with more than one match.
343 For entries
344 with exactly one match it includes a difference report.
345 Normally,
346 to reduce the volume of the report, use references are
347 not resolved before looking for differences, but resolution can be forced
348 by also specifying \fB\-r\fR.
349 .TP 5
350 \fB\-f\fR
351 Display complex terminfo strings which contain if/then/else/endif expressions
352 indented for readability.
353 .TP 5
354 \fB\-G\fR
355 Display constant literals in decimal form
356 rather than their character equivalents.
357 .TP 5
358 \fB\-g\fR
359 Display constant character literals in quoted form
360 rather than their decimal equivalents.
361 .TP 5
362 \fB\-i\fR
363 Analyze the initialization (\fBis1\fR, \fBis2\fR, \fBis3\fR), and reset
364 (\fBrs1\fR, \fBrs2\fR, \fBrs3\fR), strings in the entry,
365 as well as those used for starting/stopping cursor-positioning mode
366 (\fBsmcup\fP, \fBrmcup\fP) as well as starting/stopping keymap mode
367 (\fBsmkx\fP, \fBrmkx\fP).
368 .IP
369 For each string, the
370 code tries to analyze it into actions in terms of the other capabilities in the
371 entry, certain X3.64/ISO 6429/ECMA\-48 capabilities, and certain DEC VT-series
372 private modes (the set of recognized special sequences has been selected for
373 completeness over the existing terminfo database).
374 Each report line consists
375 of the capability name, followed by a colon and space, followed by a printable
376 expansion of the capability string with sections matching recognized actions
377 translated into {}-bracketed descriptions.
378 .IP
379 Here is a list of the DEC/ANSI
380 special sequences recognized:
381 .TS
382 center tab(/) ;
383 l l
384 l l.
385 Action/Meaning
386 =
387 RIS/full reset
388 SC/save cursor
389 RC/restore cursor
390 LL/home-down
391 RSR/reset scroll region
392 =
393 DECSTR/soft reset (VT320)
394 S7C1T/7-bit controls (VT220)
395 =
396 ISO DEC G0/enable DEC graphics for G0
397 ISO UK G0/enable UK chars for G0
398 ISO US G0/enable US chars for G0
399 ISO DEC G1/enable DEC graphics for G1
400 ISO UK G1/enable UK chars for G1
401 ISO US G1/enable US chars for G1
402 =
403 DECPAM/application keypad mode
404 DECPNM/normal keypad mode
405 DECANSI/enter ANSI mode
406 =
407 ECMA[+\-]AM/keyboard action mode
408 ECMA[+\-]IRM/insert replace mode
409 ECMA[+\-]SRM/send receive mode
410 ECMA[+\-]LNM/linefeed mode
411 =
412 DEC[+\-]CKM/application cursor keys
413 DEC[+\-]ANM/set VT52 mode
414 DEC[+\-]COLM/132-column mode
415 DEC[+\-]SCLM/smooth scroll
416 DEC[+\-]SCNM/reverse video mode
417 DEC[+\-]OM/origin mode
418 DEC[+\-]AWM/wraparound mode
419 DEC[+\-]ARM/auto-repeat mode
420 .TE
421 .sp
422 It also recognizes a SGR action corresponding to ANSI/ISO 6429/ECMA Set
423 Graphics Rendition, with the values NORMAL, BOLD, UNDERLINE, BLINK, and
424 REVERSE.
425 All but NORMAL may be prefixed with
426 .RS
427 .bP
428 \*(``+\*('' (turn on) or
429 .bP
430 \*(``\-\*('' (turn off).
431 .RE
432 .IP
433 An SGR0 designates an empty highlight sequence (equivalent to {SGR:NORMAL}).
434 .TP 5
435 \fB\-l\fR
436 Set output format to terminfo.
437 .TP 5
438 \fB\-p\fR
439 Ignore padding specifications when comparing strings.
440 .TP 5
441 \fB\-Q\fR \fIn\fR
442 Rather than show source in terminfo (text) format,
443 print the compiled (binary) format in hexadecimal or base64 form,
444 depending on the option's value:
445 .RS 8
446 .TP 3
447 1
448 hexadecimal
449 .TP 3
450 2
451 base64
452 .TP 3
453 3
454 hexadecimal and base64
455 .RE
456 .IP
457 For example, this prints the compiled terminfo value as a string
458 which could be assigned to the \fBTERMINFO\fP environment variable:
459 .NS
460 @INFOCMP@ -0 -q -Q2
461 .NE
462 .TP 5
463 \fB\-q\fR
464 This makes the output a little shorter:
465 .RS
466 .bP
467 Make the comparison listing shorter by omitting subheadings, and using
468 \*(``\-\*('' for absent capabilities, \*(``@\*(''
469 for canceled rather than \*(``NULL\*(''.
470 .bP
471 However, show differences between absent and cancelled capabilities.
472 .bP
473 Omit the \*(``Reconstructed from\*('' comment for source listings.
474 .RE
475 .TP 5
476 \fB\-R\fR\fIsubset\fR
477 Restrict output to a given subset.
478 This option is for use with archaic
479 versions of terminfo like those on SVr1, Ultrix, or HP/UX that do not support
480 the full set of SVR4/XSI Curses terminfo; and variants such as AIX
481 that have their own extensions incompatible with SVr4/XSI.
482 .RS
483 .bP
484 Available terminfo
485 subsets are \*(``SVr1\*('', \*(``Ultrix\*('', \*(``HP\*('', and \*(``AIX\*('';
486 see \fBterminfo\fR(\*n) for details.
487 .bP
488 You can also choose the subset \*(``BSD\*('' which selects only capabilities
489 with termcap equivalents recognized by 4.4BSD.
490 The \fB\-C\fP option sets the \*(``BSD\*('' subset as a side-effect.
491 .bP
492 If you select any other value for \fB\-R\fP,
493 it is the same as no subset, i.e., all capabilities are used.
494 The \fB\-I\fP option likewise selects no subset as a side-effect.
495 .RE
496 .TP
497 \fB\-s \fR\fI[d|i|l|c]\fR
498 The \fB\-s\fR option sorts the fields within each type according to the argument
499 below:
500 .br
501 .RS 5
502 .TP 5
503 \fBd\fR
504 leave fields in the order that they are stored in the \fIterminfo\fR database.
505 .TP 5
506 \fBi\fR
507 sort by \fIterminfo\fR name.
508 .TP 5
509 \fBl\fR
510 sort by the long C variable name.
511 .TP 5
512 \fBc\fR
513 sort by the \fItermcap\fR name.
514 .RE
515 .IP
516 If the \fB\-s\fR option is not given, the fields printed out will be
517 sorted alphabetically by the \fBterminfo\fR name within each type,
518 except in the case of the \fB\-C\fR or the \fB\-L\fR options, which cause the
519 sorting to be done by the \fBtermcap\fR name or the long C variable
520 name, respectively.
521 .TP 5
522 \fB\-T\fR
523 eliminates size-restrictions on the generated text.
524 This is mainly useful for testing and analysis, since the compiled
525 descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo).
526 .TP
527 \fB\-t\fR
528 tells \fB@TIC@\fP to discard commented-out capabilities.
529 Normally when translating from terminfo to termcap,
530 untranslatable capabilities are commented-out.
531 .TP 5
532 \fB\-U\fR
533 tells \fB@INFOCMP@\fP to not post-process the data
534 after parsing the source file.
535 This feature helps when comparing the actual contents of two source files,
536 since it excludes the inferences that \fB@INFOCMP@\fP makes to fill in missing
537 data.
538 .TP 5
539 \fB\-V\fR
540 reports the version of ncurses which was used in this program, and exits.
541 .TP 5
542 \fB\-v\fR \fIn\fR
543 prints out tracing information on standard error as the program runs.
544 .IP
545 The optional parameter \fIn\fR is a number from 1 to 10, inclusive,
546 indicating the desired level of detail of information.
547 If ncurses is built without tracing support, the optional parameter is ignored.
548 .TP
549 \fB\-W\fR
550 By itself, the \fB\-w\fP option will not force long strings to be wrapped.
551 Use the \fB\-W\fP option to do this.
552 .TP 5
553 \fB\-w\fR \fIwidth\fR
554 changes the output to \fIwidth\fR characters.
555 .TP
556 \fB\-x\fR
557 print information for user-defined capabilities (see \fBuser_caps(\*n)\fP.
558 These are extensions to the terminfo repertoire which can be loaded
559 using the \fB\-x\fR option of \fB@TIC@\fP.
560 .SH FILES
561 .TP 20
562 \*d
563 Compiled terminal description database.
564 .SH HISTORY
565 Although System V Release 2 provided a terminfo library,
566 it had no documented tool for decompiling the terminal descriptions.
567 Tony Hansen (AT&T) wrote the first \fBinfocmp\fP in early 1984,
568 for System V Release 3.
569 .PP
570 Eric Raymond used the AT&T documentation in 1995 to provide an equivalent
571 \fB@INFOCMP@\fP for ncurses.
572 In addition, he added a few new features such as:
573 .bP
574 the \fB\-e\fP option, to support \fIfallback\fP
575 (compiled-in) terminal descriptions
576 .bP
577 the \fB\-i\fP option, to help with analysis 
578 .PP
579 Later, Thomas Dickey added the \fB\-x\fP (user-defined capabilities)
580 option, and the \fB\-E\fP option to support fallback entries with
581 user-defined capabilities.
582 .PP
583 For a complete list, see the \fIEXTENSIONS\fP section.
584 .PP
585 In 2010, Roy Marples provided an \fBinfocmp\fP program for NetBSD.
586 It is less capable than the SVr4 or ncurses versions
587 (e.g., it lacks the sorting options documented in X/Open),
588 but does include the \fB\-x\fP option adapted from ncurses.
589 .SH PORTABILITY
590 X/Open Curses, Issue 7 (2009) provides a description of \fBinfocmp\fP.
591 It does not mention the options used for converting to termcap format.
592 .SH EXTENSIONS
593 The
594 \fB\-0\fR,
595 \fB\-1\fR,
596 \fB\-E\fR,
597 \fB\-F\fR,
598 \fB\-G\fR,
599 \fB\-Q\fR,
600 \fB\-R\fR,
601 \fB\-T\fR,
602 \fB\-V\fR,
603 \fB\-a\fR,
604 \fB\-e\fR,
605 \fB\-f\fR,
606 \fB\-g\fR,
607 \fB\-i\fR,
608 \fB\-l\fR,
609 \fB\-p\fR,
610 \fB\-q\fR and
611 \fB\-t\fR
612 options are not supported in SVr4 curses.
613 .PP
614 SVr4 infocmp does not distinguish between absent and cancelled capabilities.
615 Also, it shows missing integer capabilities as \fB\-1\fP
616 (the internal value used to represent missing integers).
617 This implementation shows those as \*(``NULL\*('',
618 for consistency with missing strings.
619 .PP
620 The \fB\-r\fR option's notion of \*(``termcap\*('' capabilities
621 is System V Release 4's.
622 Actual BSD curses versions will have a more restricted set.
623 To see only the
624 4.4BSD set, use \fB\-r\fR \fB\-RBSD\fR.
625 .SH BUGS
626 The \fB\-F\fR option of \fB@INFOCMP@\fR(1M) should be a \fB@TOE@\fR(1M) mode.
627 .SH SEE ALSO
628 \fB@CAPTOINFO@\fR(1M),
629 \fB@INFOTOCAP@\fR(1M),
630 \fB@TIC@\fR(1M),
631 \fB@TOE@\fR(1M),
632 \fBcurses\fR(3X),
633 \fBterminfo\fR(\*n).
634 \fBuser_caps\fR(\*n).
635 .sp
636 https://invisible-island.net/ncurses/tctest.html
637 .PP
638 This describes \fBncurses\fR
639 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
640 .SH AUTHOR
641 Eric S. Raymond <esr@snark.thyrsus.com>
642 and
643 .br
644 Thomas E. Dickey <dickey@invisible-island.net>