X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcaptoinfo.1m;h=ddf60346f557071c508ecad7abdd85c052160432;hb=3f57ad09dfcb62c8ad444e13fa4d450c05e878ba;hp=2938ec6c9fce3e7adbf3a999f2ca7cbc17936920;hpb=a8987e73ec254703634802b4f7ee30d3a485524d;p=ncurses.git diff --git a/man/captoinfo.1m b/man/captoinfo.1m index 2938ec6c..ddf60346 100644 --- a/man/captoinfo.1m +++ b/man/captoinfo.1m @@ -1,6 +1,7 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2000,2003 Free Software Foundation, Inc. * +.\" Copyright 2018-2021,2022 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 * @@ -27,39 +28,45 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.17 2003/05/11 00:32:53 tom Exp $ -.TH captoinfo 1M "" +.\" $Id: captoinfo.1m,v 1.33 2022/02/12 20:07:29 tom Exp $ +.TH @CAPTOINFO@ 1M "" .ds n 5 .ds d @TERMINFO@ .SH NAME -\fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description +\fB@CAPTOINFO@\fP \- convert a \fItermcap\fP description into a \fIterminfo\fP description .SH SYNOPSIS -\fBcaptoinfo\fR [\fB\-v\fR\fIn\fR \fIwidth\fR] [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR . . . +\fB@CAPTOINFO@\fR [\fB\-v\fIn\fR \fIwidth\fR] [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR ... .SH DESCRIPTION -\fBcaptoinfo\fR looks in \fIfile\fR for \fBtermcap\fR descriptions. For each -one found, an equivalent \fBterminfo\fR description is written to standard -output. Termcap \fBtc\fR capabilities are translated directly to terminfo -\fBuse\fR capabilities. - -If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used -for the filename or entry. If \fBTERMCAP\fR is a full pathname to a file, only -the terminal whose name is specified in the environment variable \fBTERM\fR is -extracted from that file. If the environment variable \fBTERMCAP\fR is not -set, then the file \fB\*d\fR is read. +\fB@CAPTOINFO@\fP looks in each given text +\fIfile\fP for \fBtermcap\fP descriptions. +For each +one found, an equivalent \fBterminfo\fP description is written to standard +output. +Termcap \fBtc\fP capabilities are translated directly to terminfo +\fBuse\fP capabilities. +.PP +If no \fIfile\fP is given, then the environment variable \fBTERMCAP\fP is used +for the filename or entry. +If \fBTERMCAP\fP is a full pathname to a file, only +the terminal whose name is specified in the environment variable \fBTERM\fP is +extracted from that file. +If the environment variable \fBTERMCAP\fP is not +set, then the file \fB\*d\fP is read. .TP 5 -\fB\-v\fR +\fB\-v\fP print out tracing information on standard error as the program runs. .TP 5 -\fB\-V\fR +\fB\-V\fP print out the version of the program in use on standard error and exit. .TP 5 -\fB\-1\fR -cause the fields to print out one to a line. Otherwise, the fields +\fB\-1\fP +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. .TP 5 -\fB\-w\fR -change the output to \fIwidth\fR characters. +\fB\-w\fP +change the output to \fIwidth\fP characters. .SH FILES .TP 20 \*d @@ -67,7 +74,7 @@ Compiled terminal description database. .SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES .PP Some obsolete nonstandard capabilities will automatically be translated -into standard (SVr4/XSI Curses) terminfo capabilities by \fBcaptoinfo\fR. +into standard (SVr4/XSI Curses) terminfo capabilities by \fB@CAPTOINFO@\fP. Whenever one of these automatic 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 random @@ -112,7 +119,8 @@ HS mh Iris enter_dim_mode .PP 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: +high-half graphics. +They were as follows: .PP .TS H c c @@ -145,13 +153,14 @@ GG acs magic cookie count .TE .PP If the single-line capabilities occur in an entry, they will automatically -be composed into an \fBacsc\fR string. The double-line capabilities and -\fBGG\fR are discarded with a warning message. +be composed into an \fBacsc\fP string. +The double-line capabilities and +\fBGG\fP are discarded with a warning message. .PP IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible -with the SVr4 format. The following AIX extensions are automatically +with the SVr4 format. +The following AIX extensions are automatically translated: -.PP .TS c c l l. @@ -165,25 +174,34 @@ font2 s2ds font3 s3ds .TE .PP -Additionally, the AIX \fBbox1\fR capability will be automatically translated to -an \fBacsc\fR string. +Additionally, the AIX \fIbox1\fP capability will be automatically translated to +an \fBacsc\fP string. .PP Hewlett-Packard's terminfo library supports two nonstandard terminfo -capabilities \fBmeml\fR (memory lock) and \fBmemu\fR (memory unlock). +capabilities \fBmeml\fP (memory lock) and \fBmemu\fP (memory unlock). These will be discarded with a warning message. .SH NOTES -This utility is actually a link to \fItic\fR(1M), running in \fI\-I\fR mode. -You can use other \fItic\fR options such as \fB\-f\fR and \fB\-x\fR. - -The trace option isn't identical to SVr4's. Under SVr4, instead of following -the \fB\-v\fR with a trace level n, you repeat it n times. +This utility is actually a link to \fB@TIC@\fP(1M), running in \fI\-I\fP mode. +You can use other \fB@TIC@\fP options such as \fB\-f\fP and \fB\-x\fP. +.PP +The verbose option is not identical to SVr4's. +Under SVr4, instead of following +the \fB\-v\fP with a trace level n, you repeat it n times. +.SH PORTABILITY +X/Open Curses, Issue 7 (2009) describes \fBtic\fP briefly, +but omits this program. +SVr4 systems provide \fBcaptoinfo\fP as a separate application from \fBtic\fP. +.PP +NetBSD does not provide this application. .SH SEE ALSO -\fBcurses\fR(3X), \fB@INFOCMP@\fR(1M), \fBterminfo\fR(\*n) +\fB@INFOCMP@\fP(1M), +\fBcurses\fP(3X), +\fBterminfo\fP(\*n) +.PP +This describes \fBncurses\fP +version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@). .SH AUTHOR Eric S. Raymond -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: +and +.br +Thomas E. Dickey