ncurses 6.4 - patch 20231001

[ncurses.git] / man / infotocap.1m

diff --git a/man/infotocap.1m b/man/infotocap.1m
index 1d74088a09f1d683c5f9cb84a26eb9c82fe55bb1..78505b107c9038336dccf6117ccdcdc749c36f7e 100644 (file)
--- a/man/infotocap.1m
+++ b/man/infotocap.1m
@@ -1,4 +1,3 @@
-'\" t
 .\"***************************************************************************
 .\" Copyright 2018-2022,2023 Thomas E. Dickey                                *
 .\" Copyright 1999-2010,2016 Free Software Foundation, Inc.                  *
@@ -28,55 +27,63 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: infotocap.1m,v 1.26 2023/09/16 23:38:39 tom Exp $
-.TH @INFOTOCAP@ 1M 2023-09-16 "ncurses 6.4" "User commands"
+.\" $Id: infotocap.1m,v 1.33 2023/10/01 22:43:17 tom Exp $
+.TH @INFOTOCAP@ 1M 2023-10-01 "ncurses 6.4" "User commands"
+.ie \n(.g .ds `` \(lq
+.el       .ds `` ``
+.ie \n(.g .ds '' \(rq
+.el       .ds '' ''
 .ds n 5
 .ds d @TERMINFO@
 .SH NAME
 \fB\%@INFOTOCAP@\fP \-
 convert a \fIterminfo\fR description into a \fItermcap\fR description
 .SH SYNOPSIS
-\fB@INFOTOCAP@\fR [\fB\-v\fIn\fR \fIwidth\fR]  [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR ...
+.B @INFOTOCAP@
+.RI [ tic-option ]
+.I file
+\&.\|.\|.
+.P
+.B "@INFOTOCAP@ \-V"
 .SH DESCRIPTION
-\fB@INFOTOCAP@\fP looks in each given text
-\fIfile\fP for \fBterminfo\fP descriptions.
-For each terminfo description found,
-an equivalent \fBtermcap\fP description is written to standard output.
-Terminfo \fBuse\fP capabilities are translated directly to termcap
-\fBtc\fP capabilities.
-.TP 5
-\fB\-v\fP
-print out tracing information on standard error as the program runs.
-.TP 5
-\fB\-V\fP
-print out the version of the program in use on standard error and exit.
-.TP 5
-\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\fP
-change the output to \fIwidth\fP characters.
+\fB\%@INFOTOCAP@\fP looks in each given text
+\fIfile\fP for \fIterminfo\fP descriptions.
+For each one found,
+it writes an analogous \fItermcap\fP description to the standard output
+stream.
+\fIterminfo\fP \*(``\fBuse\fP\*('' capabilities are translated directly
+to \fItermcap\fP \fBtc\fP capabilities.
+Because \fItermcap\fP is a less expressive format than \fIterminfo\fP,
+some capabilities cannot be translated.
+.PP
+This utility is implemented as a link to \fB\%@TIC@\fP(1M),
+with the latter's
+.B \-C
+option implied.
+You can use other \fB\%@TIC@\fP options such as
+.BR \-1 ,
+.BR \-f ,
+.BR \-v ,
+.BR \-w ,
+and
+.BR \-x .
+The \fB\-V\fP option reports the version of \fIncurses\fP associated
+with this program and exits with a successful status.
 .SH FILES
-.TP 20
-\*d
-Compiled terminal description database.
-.SH NOTES
-This utility is actually a link to \fB@TIC@\fP, running in \fI\-C\fP mode.
-You can use other \fB@TIC@\fP options such as \fB\-f\fP and  \fB\-x\fP.
+.TP
+\fI\*d\fP
+compiled terminal description database
 .SH PORTABILITY
-None of X/Open Curses, Issue 7 (2009), SVr4 or NetBSD document this application.
-.SH SEE ALSO
-\fB@INFOCMP@\fP(1M),
-\fB@TIC@\fP(1M),
-\fBcurses\fP(3X),
-\fBterminfo\fP(\*n)
-.PP
-This describes \fBncurses\fP
-version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
+None of X/Open Curses, Issue 7 (2009),
+SVr4,
+or NetBSD document this application.
 .SH AUTHOR
 Eric S. Raymond <esr@snark.thyrsus.com>
 and
 .br
 Thomas E. Dickey <dickey@invisible-island.net>
+.SH SEE ALSO
+\fB\%@INFOCMP@\fP(1M),
+\fB\%@TIC@\fP(1M),
+\fB\%curses\fP(3X),
+\fB\%terminfo\fP(\*n)