summaryrefslogtreecommitdiff
path: root/usr.bin/tset/tset.1
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>2000-03-11 21:40:09 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>2000-03-11 21:40:09 +0000
commit80e5779001a9337a84f29f2a1e46f0022fb98026 (patch)
treee15e37ecf0918c142b82398da2f0dee4a897b4ca /usr.bin/tset/tset.1
parentd7d5044e2ea6ec17428055f7a436dfe704ec1fb7 (diff)
Various cleanups and standardizations.
Diffstat (limited to 'usr.bin/tset/tset.1')
-rw-r--r--usr.bin/tset/tset.185
1 files changed, 45 insertions, 40 deletions
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 <LF>reset<LF>
+.Dq <LF>reset<LF>
(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 .