X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Ftic.1m;h=f0a627d96af8eefd54d5d0bed960c961453496be;hp=07111e897daad3004ecdd06242b652e86d4344a0;hb=fae162795e065e5901068152e91f2962b6b247f3;hpb=a8dfaf0998c91b39c5c0a4913987cd67ca622bff diff --git a/man/tic.1m b/man/tic.1m index 07111e89..f0a627d9 100644 --- a/man/tic.1m +++ b/man/tic.1m @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2018,2019 Free Software Foundation, Inc. * +.\" Copyright 2018-2019,2020 Thomas E. Dickey * +.\" Copyright 1998-2016,2017 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 * @@ -26,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tic.1m,v 1.74 2019/07/20 17:57:09 tom Exp $ +.\" $Id: tic.1m,v 1.78 2020/12/19 21:32:45 tom Exp $ .TH @TIC@ 1M "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -98,7 +99,7 @@ default directory name (only adding a ".db" suffix). .PP In either case (directory or hashed database), \fB@TIC@\fP will create the container if it does not exist. -For a directory, this would be the "terminfo" leaf, +For a directory, this would be the \*(``terminfo\*('' leaf, versus a "terminfo.db" file. .PP The results are normally placed in the system terminfo database \fB\*d\fR. @@ -128,6 +129,14 @@ directories listed in the TERMINFO_DIRS environment variable, a compiled-in list of directories (@TERMINFO_DIRS@), and .bP the system terminfo database (\fI\*d\fR). +.SS ALIASES +.PP +This is the same program as @INFOTOCAP@ and @CAPTOINFO@; +usually those are linked to, or copied from this program: +.bP +When invoked as @INFOTOCAP@, @TIC@ sets the \fB\-I\fP option. +.bP +When invoked as @CAPTOINFO@, @TIC@ sets the \fB\-C\fP option. .SS OPTIONS .TP \fB\-0\fR @@ -274,7 +283,7 @@ versions of terminfo like those on SVr1, Ultrix, or HP/UX that do not support the full set of SVR4/XSI Curses terminfo; and outright broken ports like AIX 3.x that have their own extensions incompatible with SVr4/XSI. Available subsets -are "SVr1", "Ultrix", "HP", "BSD" and "AIX"; +are \*(``SVr1\*('', \*(``Ultrix\*('', \*(``HP\*('', \*(``BSD\*('' and \*(``AIX\*(''; see \fBterminfo\fR(\*n) for details. .TP \fB\-r\fR @@ -443,7 +452,7 @@ to support user-defined capabilities. .PP In 2010, Roy Marples provided a \fBtic\fP program and terminfo library for NetBSD. -This implementation adapts several features from ncurses, +That implementation adapts several features from ncurses, including \fB@TIC@\fP's \fB\-x\fP option. .PP The \fB\-c\fP option tells \fB@TIC@\fP to check for problems in the @@ -478,6 +487,9 @@ As of 2019, the surviving implementations of \fBtic\fP are SVr4 (AIX, HP-UX and Solaris), ncurses and NetBSD curses. +The SVr4 \fBtic\fP programs all support the \fB\-v\fP option. +The NetBSD \fBtic\fP program follows X/Open's documentation, +omitting the \fB\-v\fP option. .PP The X/Open rationale states that some implementations of \fBtic\fP read terminal descriptions from the standard input if the \fIfile\fP @@ -514,27 +526,44 @@ compiled entries. The error messages from this \fB@TIC@\fR have the same format as GNU C error messages, and can be parsed by GNU Emacs's compile facility. .PP -The -\fB\-0\fR, -\fB\-1\fR, -\fB\-C\fR, -\fB\-G\fR, -\fB\-I\fR, -\fB\-N\fR, -\fB\-R\fR, -\fB\-T\fR, -\fB\-V\fR, -\fB\-a\fR, -\fB\-e\fR, -\fB\-f\fR, -\fB\-g\fR, -\fB\-o\fR, -\fB\-r\fR, -\fB\-s\fR, -\fB\-t\fR and +Aside from \fB\-c\fP and \fB\-v\fP, options are not portable: +.bP +Most of @TIC@'s options +are not supported by SVr4 \fBtic\fP: +.sp +.RS +\fB\-0\fR +\fB\-1\fR +\fB\-C\fR +\fB\-G\fR +\fB\-I\fR +\fB\-N\fR +\fB\-R\fR +\fB\-T\fR +\fB\-V\fR +\fB\-a\fR +\fB\-e\fR +\fB\-f\fR +\fB\-g\fR +\fB\-o\fR +\fB\-r\fR +\fB\-s\fR +\fB\-t\fR \fB\-x\fR -options -are not supported under SVr4. +.RE +.bP +The NetBSD \fBtic\fP supports a few of the ncurses options +.sp +.RS +\fB\-a\fP +\fB\-o\fP +\fB\-x\fP +.RE +.IP +and adds \fB\-S\fP +(a feature which does the same thing +as @INFOCMP@'s \fB\-e\fP and \fB\-E\fP options). +.PP The SVr4 \fB\-c\fR mode does not report bad \*(``use=\*('' links. .PP System V does not compile entries to or read entries from your @@ -544,8 +573,8 @@ System V does not compile entries to or read entries from your \fB\*d/?/*\fR Compiled terminal description database. .SH SEE ALSO -\fB@INFOCMP@\fR(1M), \fB@CAPTOINFO@\fR(1M), +\fB@INFOCMP@\fR(1M), \fB@INFOTOCAP@\fR(1M), \fB@TOE@\fR(1M), \fBcurses\fR(3X),