X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fterm.7;h=7eda6fbd58701a2003a43446d30e707dcba941cf;hp=9d0f6d35ddb968b2318bc5a694fa5cb98f01e707;hb=3511767aa77f332927de0c4a610f9fb37ea18101;hpb=3a9b6a3bf0269231bef7de74757a910dedd04e0c;ds=sidebyside diff --git a/man/term.7 b/man/term.7 index 9d0f6d35..7eda6fbd 100644 --- a/man/term.7 +++ b/man/term.7 @@ -1,6 +1,35 @@ -.TH TERM 7 +.\"*************************************************************************** +.\" Copyright (c) 1998-2006,2007 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: term.7,v 1.18 2007/06/02 20:40:07 tom Exp $ +.TH term 7 .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME term \- conventions for naming terminal types .SH DESCRIPTION @@ -26,7 +55,7 @@ can almost always be avoided by explicitly exporting `vt100' (assuming you are in fact using a VT100-superset console, terminal, or terminal emulator.) .PP In any case, you are free to override the system \fBTERM\fR setting to your -taste in your shell profile. The \fBtset\fB(1) utility may be of assistance; +taste in your shell profile. The \fBtset\fP(1) utility may be of assistance; you can give it a set of rules for deducing or requesting a terminal type based on the tty device and baud rate. .PP @@ -35,21 +64,21 @@ custom entry incorporating options (such as visual bell or reverse-video) which you wish to override the system default type for your line. .PP Terminal type descriptions are stored as files of capability data underneath -\*d. To browse a list of all terminal names recognized by the system, do - - toe | more - +\*d. To browse a list of all terminal names recognized by the system, do +.sp + @TOE@ | more +.sp from your shell. These capability files are in a binary format optimized for retrieval speed (unlike the old text-based \fBtermcap\fR format they replace); -to examine an entry, you must use the \fBinfocmp\fR(1) command. Invoke it as -follows: - - infocmp \fIentry-name\fR - +to examine an entry, you must use the \fB@INFOCMP@\fR(1M) command. +Invoke it as follows: +.sp + @INFOCMP@ \fIentry-name\fR +.sp where \fIentry-name\fR is the name of the type you wish to examine (and the name of its capability file the subdirectory of \*d named for its first letter). This command dumps a capability file in the text format described by -\fBterminfo\fR(\*n). +\fBterminfo\fR(\*n). .PP The first line of a \fBterminfo\fR(\*n) description gives the names by which terminfo knows a terminal, separated by `|' (pipe-bar) characters with the last @@ -67,7 +96,7 @@ terminals that also explains how to parse them: First, choose a root name. The root will consist of a lower-case letter followed by up to seven lower-case letters or digits. You need to avoid using punctuation characters in root names, because they are used and interpreted as -filenames and shell meta-characters (such as !, $, *, ? etc.) embedded in them +filenames and shell meta-characters (such as !, $, *, ?, etc.) embedded in them may cause odd and unhelpful behavior. The slash (/), or any other character that may be interpreted by anyone's file system (\e, $, [, ]), is especially dangerous (terminfo is platform-independent, and choosing names with special @@ -85,12 +114,12 @@ The root name prefix should be followed when appropriate by a model number; thus \fBvt100\fR, \fBhp2621\fR, \fBwy50\fR. .PP The root name for a PC-Unix console type should be the OS name, -i.e. \fBlinux\fR, \fBbsdos\fR, \fBfreebsd\fB, \fBnetbsd\fR. It should +i.e. \fBlinux\fR, \fBbsdos\fR, \fBfreebsd\fR, \fBnetbsd\fR. It should \fInot\fR be \fBconsole\fR or any other generic that might cause confusion in a multi-platform environment! If a model number follows, it should indicate either the OS release level or the console driver release level. .PP -The root name for a terminal emulator (assuming it doesn't fit one of the +The root name for a terminal emulator (assuming it does not fit one of the standard ANSI or vt100 types) should be the program name or a readily recognizable abbreviation of it (i.e. \fBversaterm\fR, \fBctrm\fR). .PP @@ -107,29 +136,29 @@ with another that has this suffix and uses magic cookies to support multiple attributes. .TP 5 -am -Enable auto-margin (right-margin wraparound) +Enable auto-margin (right-margin wraparound). .TP 5 -m -Mono mode - suppress color support +Mono mode - suppress color support. .TP 5 -na No arrow keys - termcap ignores arrow keys which are actually there on the terminal, so the user can use the arrow keys locally. .TP 5 -nam -No auto-margin - suppress am capability +No auto-margin - suppress am capability. .TP 5 -nl -No labels - suppress soft labels +No labels - suppress soft labels. .TP 5 -nsl -No status line - suppress status line +No status line - suppress status line. .TP 5 -pp Has a printer port which is used. .TP 5 -rv -Terminal in reverse video mode (black on white) +Terminal in reverse video mode (black on white). .TP 5 -s Enable status line. @@ -140,13 +169,13 @@ Use visible bell (flash) rather than beep. -w Wide; terminal is in 132 column mode. .PP -Conventionally, if your terminal type is a variant intended to specify a +Conventionally, if your terminal type is a variant intended to specify a line height, that suffix should go first. So, for a hypothetical FuBarCo model 2317 terminal in 30-line mode with reverse video, best form would be \fBfubar-30-rv\fR (rather than, say, `fubar-rv-30'). .PP Terminal types that are written not as standalone entries, but rather as -components to be plugged into other entries via \fBuse\fB capabilities, +components to be plugged into other entries via \fBuse\fP capabilities, are distinguished by using embedded plus signs rather than dashes. .PP Commands which use a terminal type to control display often accept a -T @@ -161,12 +190,12 @@ should be unique within the first 14 characters. compiled terminal capability data base .TP 5 /etc/inittab -tty line initialization (AT&T-like UNIXes). +tty line initialization (AT&T-like UNIXes) .TP 5 /etc/ttys -tty line initialization (BSD-like UNIXes). -.SH "SEE ALSO" -curses(3X), terminfo(\*n), term(\*d). +tty line initialization (BSD-like UNIXes) +.SH SEE ALSO +\fBcurses\fR(3X), \fBterminfo\fR(\*n), \fBterm\fR(\*n). .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: