captoinfo(1M) DG/UX R4.11MU05 captoinfo(1M)
NAME
captoinfo - convert a TERMCAP entry into a TERMINFO entry
SYNOPSIS
captoinfo [-v ...] [-V] [-1] [-w width] [file] ...
where:
width is the maximum output width desired, an integer
file is the pathname of a file in termcap(5) format
DESCRIPTION
The captoinfo utility looks in file for termcap(5) descriptions. For
each one found, an equivalent terminfo(4) description is written to
standard output, along with any comments found. A description which
is expressed as relative to another description (as specified by the
termcap(5) tc=term field) will be reduced to the minimum superset
before being output.
If no file is given, then the environment variable TERMCAP is used
for the filename or entry. If the value of TERMCAP is a full
pathname to a file, only the terminal named by the value of the
environment variable TERM is extracted from that file. Otherwise,
the value of TERMCAP is interpreted as one or more termcap(5)
entries, all of which are extracted. If the environment variable
TERMCAP is not set, then the default termcap(5) file
/usr/share/lib/termcap is read.
Options are:
-v Print out tracing information on standard error as the program
runs. Specifying an additional -v option will cause more
detailed information to be printed.
-V Print out the version of the program in use on standard error,
and exit.
-1 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.
-w width
Change the maximum output width to width characters.
FILES
/usr/share/lib/terminfo/?/*
compiled terminal description database
/usr/share/lib/termcap
old, textual terminal description database
DIAGNOSTICS
Command line syntax errors cause captoinfo to print a usage message
to standard error. Other errors cause captoinfo to produce
diagnostic messages as described below. Most of these messages are
preceded by the name of the entry causing the error.
tgetent failed with return code n (reason).
The termcap(5) entry is not valid for the specified reason. In
particular, check for an invalid tc= field.
commented out code 'cc' is unknown.
An unknown commented out termcap code cc was encountered.
unknown type given for the termcap code 'cc'.
The termcap(5) description had a field cc for which the type was not
boolean, numeric, or string.
wrong type given for the boolean termcap code 'cc'.
wrong type given for the numeric termcap code 'cc'.
wrong type given for the string termcap code 'cc'.
The termcap field cc was entered as a capability of the wrong type;
for instance, a boolean field was entered as a numeric capability.
the boolean termcap code 'cc' is not a valid name.
the numeric termcap code 'cc' is not a valid name.
the string termcap code 'cc' is not a valid name.
An unknown termcap(5) code cc was encountered.
cap cc (info ii) is NULL: REMOVED
The termcap(5) field cc, which translates to terminfo(4) capability
ii, was specified as a null string. The correct way to cancel a
field is to follow it with the @ character; for example, :bs@:.
Giving a null string could cause incorrect assumptions to be made by
software which uses termcap(5) or terminfo(4).
obsolete 2 character name 'ss' removed.
synonyms are: 'string'
An obsolete two-letter terminal name ss in the current termcap(5)
entry was not propagated into the terminfo(4) entry. The synonyms
listed in string will still be incorporated, though.
a function key for 'cc' was specified with the value vv1, but it
already has the value vv2.
When parsing the ko field, the key cc was specified as having the
same value as the capability vv1, but cc already had the value vv2.
the unknown termcap name 'cc' was
specified in the 'ko' termcap capability.
A key cc which could not be handled was specified in the ko
capability.
the vi character 'v' (info 'ii') has the value 'xx', but 'ma' gives
'n'.
The ma field specified a function v, equivalent to terminfo(4)
capability ii, with a value n. However, the key represented by v had
previously been set to a different value xx.
the unknown vi key 'v' was
specified in the 'ma' termcap capability.
A key unknown to captoinfo was specified in the ma capability.
Warning: termcap sg and ug had different values (nn1<->nn2).
The termcap(5) value for the sg field (nn1) was different from the
value for the ug field (nn2), but terminfo(4) can represent only one
of these values; sg translates into xmc, which is assumed to have the
same value as ug).
Warning: the string produced for 'ii' may be inefficient.
The parameterized string created for field ii should be rewritten by
hand.
Null termname given.
The terminal type was null. This message is printed if the
environment variable TERM is not set or is null.
cannot open file for reading.
The file file could not be opened for read-only access.
the boolean name 'info' was not found!
the numeric name 'info' was not found!
the string name 'info' was not found!
The terminfo(4) capability info does not exist. This message
indicates an internal error in captoinfo.
SEE ALSO
infocmp(1M), tic(1M), curses(3X), terminfo(4), termcap(5)
NOTES
Captoinfo should be used to convert termcap(5) entries to terminfo(4)
entries because programs that use curses(3X) depend upon terminfo(4).
Certain termcap(5) defaults are assumed to be true. For example, the
bell character (terminfo(4) bel) is assumed to be ^g. The linefeed
capability (termcap(5) nl) is assumed to be the same for both
cursordown and scrollforward (terminfo(4) cud1 and ind,
respectively). Padding information is assumed to belong at the end
of the string.
The algorithm used to expand parameterized information for termcap(5)
fields such as cursorposition (termcap(5) cm, terminfo(4) cup) will
sometimes produce a string which, though technically correct, may not
be optimal. In particular, the rarely used termcap(5) operation %n
will produce strings that are especially long. Most occurrences of
these non-optimal strings will be flagged with a warning message and
may need to be recoded by hand.
The short two-letter name at the beginning of the list of names in a
termcap(5) entry, a hold-over from an earlier version of the
termcap(5) convention, will be deleted.
Licensed material--property of copyright holder(s)