X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fterm.7;h=cf815b52f748968002e77e4344cc2b26312146db;hp=e8f81bb6f0d734ee6f431d050651251a130e4ff9;hb=4f10f7dff42e5348b814bdce71d3e4d925bd6ed6;hpb=0eb88fc5281804773e2a0c7a488a4452463535ce diff --git a/man/term.7 b/man/term.7 index e8f81bb6..cf815b52 100644 --- a/man/term.7 +++ b/man/term.7 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2007,2010 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,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.7,v 1.11 1999/01/24 02:35:14 Todd.Miller Exp $ -.TH TERM 7 +.\" $Id: term.7,v 1.20 2010/01/30 21:27:35 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 @@ -39,9 +39,9 @@ the terminal, console or display-device type you are using. This information is critical for all screen-oriented programs, including your editor and mailer. .PP A default \fBTERM\fR value will be set on a per-line basis by either -\fB/etc/inittab\fR (Linux and System-V-like UNIXes) or \fB/etc/ttys\fR (BSD -UNIXes). This will nearly always suffice for workstation and microcomputer -consoles. +\fB/etc/inittab\fR (e.g., System-V-like UNIXes) +or \fB/etc/ttys\fR (BSD UNIXes). +This will nearly always suffice for workstation and microcomputer consoles. .PP If you use a dialup line, the type of device attached to it may vary. Older UNIX systems pre-set a very dumb terminal type like `dumb' or `dialup' on @@ -65,16 +65,16 @@ 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 - +.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 @@ -96,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 @@ -114,14 +114,14 @@ 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\fR, \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). +recognizable abbreviation of it (i.e., \fBversaterm\fR, \fBctrm\fR). .PP Following the root name, you may add any reasonable number of hyphen-separated feature suffixes. @@ -136,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. @@ -190,11 +190,11 @@ 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" +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