X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Ftic.1m;h=7f8fe496593f1abe359f29bd87f0efeb1e32ea69;hp=95f806970829014961cef53cfe4d4df7c95e673f;hb=0eb88fc5281804773e2a0c7a488a4452463535ce;hpb=661078ddbde3ce0f3b06e95642fbb9b5fef7dca1 diff --git a/man/tic.1m b/man/tic.1m index 95f80697..7f8fe496 100644 --- a/man/tic.1m +++ b/man/tic.1m @@ -1,4 +1,32 @@ -.\" $Id: tic.1m,v 1.18 1998/01/17 21:11:30 tom Exp $ +.\"*************************************************************************** +.\" Copyright (c) 1998,1999 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 * +.\" "Software"), to deal in the Software without restriction, including * +.\" without limitation the rights to use, copy, modify, merge, publish, * +.\" distribute, distribute with modifications, sublicense, and/or sell * +.\" copies of the Software, and to permit persons to whom the Software is * +.\" furnished to do so, subject to the following conditions: * +.\" * +.\" The above copyright notice and this permission notice shall be included * +.\" in all copies or substantial portions of the Software. * +.\" * +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * +.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * +.\" * +.\" Except as contained in this notice, the name(s) of the above copyright * +.\" holders shall not be used in advertising or otherwise to promote the * +.\" sale, use or other dealings in this Software without prior written * +.\" authorization. * +.\"*************************************************************************** +.\" +.\" $Id: tic.1m,v 1.25 1999/03/07 02:07:06 tom Exp $ .TH tic 1M "" .ds n 5 .ds d @DATADIR@/terminfo @@ -6,11 +34,24 @@ \fBtic\fR - the \fIterminfo\fR entry-description compiler .SH SYNOPSIS \fBtic\fR +[\fB\-\ +1\ +C\ +I\ +N\ +R\ +T\ +c\ +f\ +r\ +s\ +x\ +\fR] +[\fB-e\fR \fInames\fR] +[\fB-o\fR \fIdir\fR] [\fB-v\fR[\fIn\fR]] [\fB-w\fR[\fIn\fR]] -[\fB-1hcpICNRrsTu\fR] -[\fB-e\fR \fInames\fR] -[\fB-o\fR \fIdir\fR] \fIfile\fR +\fIfile\fR .br .SH DESCRIPTION The command \fBtic\fR translates a \fBterminfo\fR file from source @@ -31,9 +72,6 @@ Libraries that read terminfo entries are expected to check for a TERMINFO directory first, look at \fI$HOME/.terminfo\fR if TERMINFO is not set, and finally look in \fI\*d\fR. .TP -\fB-h\fR -Print help message and exit. -.TP \fB-c\fR specifies to only check \fIfile\fR for errors, including syntax problems and bad use links. If you specify \fB-C\fR (\fB-I\fR) with this option, the code @@ -60,10 +98,16 @@ specifies the width of the output. \fB-1\fR restricts the output to a single column .TP -\fB-T\fR -eliminates size-restrictions on the generated text. -This is mainly useful for testing and analysis, since the compiled -descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo). +\fB-C\fR +Force source translation to termcap format. Note: this differs from the -C +option of \fIinfocmp\fR(1M) in that it does not merely translate capability +names, but also translates terminfo strings to termcap format. Capabilities +that are not translatable are left in the entry under their terminfo names +but commented out with two preceding dots. +.TP +\fB-G\fR +Display constant literals in decimal form +rather than their character equivalents. .TP \fB-I\fR Force source translation to terminfo format. @@ -72,13 +116,6 @@ Force source translation to terminfo format. Force source translation to terminfo format using the long C variable names listed in <\fBterm.h\fR> .TP -\fB-C\fR -Force source translation to termcap format. Note: this differs from the -C -option of \fIinfocmp\fR(1M) in that it does not merely translate capability -names, but also translates terminfo strings to termcap format. Capabilities -that are not translatable are left in the entry under their terminfo names -but commented out with two preceding dots. -.TP \fB-N\fR Disable smart defaults. Normally, when translating from termcap to terminfo, the compiler makes @@ -94,22 +131,23 @@ obsolete capabilities. \fB-R\fR\fIsubset\fR Restrict output to a given subset. This option is for use with archaic versions of terminfo like those on SVr1, Ultrix, or HP/UX that don't support -the full set of SVR4/XSI Curses terminfo; and outright broken ports like AIX +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"; see \fBterminfo\fR(\*n) for details. .TP -\fI-r\fR +\fB-T\fR +eliminates size-restrictions on the generated text. +This is mainly useful for testing and analysis, since the compiled +descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo). +.TP +\fB-r\fR Force entry resolution (so there are no remaining tc capabilities) even when doing translation to termcap format. This may be needed if you are preparing a termcap file for a termcap library (such as GNU termcap up to version 1.3 or BSD termcap up to 4.3BSD) that doesn't handle multiple tc capabilities per entry. .TP -\fI-s\fR -Summarize the compile by showing the directory into which entries -are written, and the number of entries which are compiled. -.TP -\fI-e\fR +\fB-e\fR Limit writes and translations to the following comma-separated list of terminals. If any name or alias of a terminal matches one of the names in @@ -119,6 +157,21 @@ The option value is interpreted as a file containing the list if it contains a '/'. (Note: depending on how tic was compiled, this option may require -I or -C.) .TP +\fB-f\fR +Display complex terminfo strings which contain if/then/else/endif expressions +indented for readability. +.TP +\fB-g\fR +Display constant character literals in quoted form +rather than their decimal equivalents. +.TP +\fB-s\fR +Summarize the compile by showing the directory into which entries +are written, and the number of entries which are compiled. +.TP +\fB-x\fR +Treat unknown capabilities as user-defined. +.TP \fIfile\fR contains one or more \fBterminfo\fR terminal descriptions in source format [see \fBterminfo\fR(\*n)]. Each description in the file @@ -171,8 +224,9 @@ If the environment variable \fBTERMINFO\fR is set, the compiled results are placed there instead of \fB\*d\fR. Total compiled entries cannot exceed 4096 bytes. The name field cannot -exceed 128 bytes. Terminal names exceeding 14 characters will be -truncated to 14 characters and a warning message will be printed. +exceed 512 bytes. Terminal names exceeding the maximum alias length +(32 characters on systems with long filenames, 14 characters otherwise) +will be truncated to the maximum alias length and a warning message will be printed. .SH COMPATIBILITY There is some evidence that historic \fBtic\fR implementations treated description fields with no whitespace in them as additional aliases or @@ -196,7 +250,21 @@ compiled entries. The error messages from this \fBtic\fR have the same format as GNU C error messages, and can be parsed by GNU Emacs's compile facility. -The -o, -I, -C, -N, -R, -h, -e, -T, -r and -s options +The +\fB-o\fR, +\fB-G\fR, +\fB-I\fR, +\fB-C\fR, +\fB-N\fR, +\fB-R\fR, +\fB-e\fR, +\fB-f\fR, +\fB-g\fR, +\fB-T\fR, +\fB-r\fR, +\fB-s\fR and +\fB-x\fR +options are not supported under SVr4. The SVr4 -c mode does not report bad use links.