From 80e5779001a9337a84f29f2a1e46f0022fb98026 Mon Sep 17 00:00:00 2001 From: Aaron Campbell Date: Sat, 11 Mar 2000 21:40:09 +0000 Subject: Various cleanups and standardizations. --- usr.bin/tset/tset.1 | 85 ++++++++++++++++++++++++++++------------------------- 1 file changed, 45 insertions(+), 40 deletions(-) (limited to 'usr.bin/tset/tset.1') diff --git a/usr.bin/tset/tset.1 b/usr.bin/tset/tset.1 index 555f20980c4..09163b5a78f 100644 --- a/usr.bin/tset/tset.1 +++ b/usr.bin/tset/tset.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tset.1,v 1.6 1998/11/16 03:08:41 millert Exp $ +.\" $OpenBSD: tset.1,v 1.7 2000/03/11 21:40:06 aaron Exp $ .\" .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -81,11 +81,12 @@ The default terminal type, .Dq unknown . .El .Pp -If the terminal type was not specified on the command-line, the +If the terminal type was not specified on the command line, the .Fl m option mappings are then applied (see below for more information). -Then, if the terminal type begins with a question mark (``?''), the user is -prompted for confirmation of the terminal type. +Then, if the terminal type begins with a question mark +.Pq Ql ? , +the user is prompted for confirmation of the terminal type. An empty response confirms the type, or, another type can be entered to specify a new type. Once the terminal type has been determined, the termcap entry for the terminal @@ -108,7 +109,7 @@ newline translation and resets any unset special characters to their default values before doing the terminal initialization described above. This is useful after a program dies leaving a terminal in an abnormal state. Note, you may have to type -.Dq Li reset +.Dq reset (the line-feed character is normally control-J) to get the terminal to work, as carriage-return may no longer work in the abnormal state. Also, the terminal will often not echo the command. @@ -117,8 +118,8 @@ The options are as follows: .Bl -tag -width flag .It Fl The terminal type is displayed to the standard output, and the terminal is -not initialized in any way. This option has been deprecated in favor of -the +not initialized in any way. +This option has been deprecated in favor of the .Fl q flag. .It Fl e Ar ch @@ -156,15 +157,15 @@ See the section below on setting the environment for details. .Pp The arguments for the .Fl e , -.Fl i +.Fl i , and .Fl k options may either be entered as actual characters or by using the .Dq hat -notation, i.e. control-h may be specified as -.Dq Li ^H +notation, i.e., control-H may be specified as +.Dq ^H or -.Dq Li ^h . +.Dq ^h . .Sh SETTING THE ENVIRONMENT It is often desirable to enter the terminal type and information about the terminal's capabilities into the shell's environment. @@ -261,24 +262,25 @@ kind of terminal''. The argument to the .Fl m option consists of an optional port type, an optional operator, an optional -baud rate specification, an optional colon (``:'') character, and a terminal -type. +baud rate specification, an optional colon +.Pq Ql : +character, and a terminal type. The port type is a string (delimited by either the operator or the colon character). The operator may be any combination of: -.Dq Li \&> , -.Dq Li \&< , -.Dq Li \&@ , +.Ql > , +.Ql < , +.Ql @ , and -.Dq Li \&! ; -.Dq Li \&> +.Ql ! ; +.Ql > means greater than, -.Dq Li \&< +.Ql < means less than, -.Dq Li \&@ +.Ql @ means equal to, and -.Dq Li \&! +.Ql ! inverts the sense of the test. The baud rate is specified as a number and is compared with the speed of the standard error output (which should be the control terminal). @@ -292,29 +294,29 @@ in the mapping replaces the current type. If more than one mapping is specified, the first applicable mapping is used. .Pp For example, consider the following mapping: -.Dq Li dialup>9600:vt100 . +.Dq dialup>9600:vt100 . The port type is -.Dq Li dialup , +.Dq dialup , the operator is -.Dq Li > , +.Dq > , the baud rate specification is -.Dq Li 9600 , +.Dq 9600 , and the terminal type is -.Dq Li vt100 . +.Dq vt100 . The result of this mapping is to specify that if the terminal type is -.Dq Li dialup , +.Dq dialup , and the baud rate is greater than 9600 baud, a terminal type of -.Dq Li vt100 +.Dq vt100 will be used. .Pp If no port type is specified, the terminal type will match any port type, for example, -.Dq Li -m dialup:vt100 -m :?xterm +.Dq -m dialup:vt100 -m :?xterm will cause any dialup port, regardless of baud rate, to match the terminal type -.Dq Li vt100 , +.Dq vt100 , and any non-dialup port type to match the terminal type -.Dq Li ?xterm . +.Dq ?xterm . Note, because of the leading question mark, the user will be queried on a default port as to whether they are actually using an .Ar xterm @@ -327,8 +329,10 @@ Also, to avoid problems with meta-characters, it is suggested that the entire .Fl m option argument be placed within single quote characters, and that .Xr csh 1 -users insert a backslash character (``\e'') before any exclamation -marks (``!''). +users insert a backslash character +.Pq Ql \e +before any exclamation marks +.Pq Ql ! . .Sh ENVIRONMENT The .Nm tset @@ -340,7 +344,7 @@ environment variables. .Sh FILES .Bl -tag -width /usr/share/misc/termcap -compact .It Pa /etc/ttys -system port name to terminal type mapping database +port name to terminal type mapping database .It Pa /usr/share/misc/termcap terminal capability database .El @@ -352,11 +356,6 @@ terminal capability database .Xr termcap 5 , .Xr ttys 5 , .Xr environ 7 -.Sh HISTORY -The -.Nm tset -command appeared in -.Bx 3.0 . .Sh COMPATIBILITY The .Nm tset @@ -374,7 +373,8 @@ also reads in the terminal entry from .Xr termcap 5 . However, this info is used for setting .Ev TERMCAP -only. If the terminal type appears in +only. +If the terminal type appears in .Xr terminfo 5 but not in .Xr termcap 5 , @@ -443,3 +443,8 @@ system of a .St -p1003.1-88 compliant terminal interface) and will no longer compile on systems with older terminal interfaces. +.Sh HISTORY +The +.Nm tset +command appeared in +.Bx 3.0 . -- cgit v1.2.3