X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Ftset.1;h=91cceb20571b1b2e8263d03a19e0d9dd69335d73;hp=1c27efa4500fc6c760b0438871577212589af196;hb=321b81e6b3fa425daddac02420d862100dc3aac8;hpb=06078d3fa68db669ed37178c01873546b4b28745 diff --git a/man/tset.1 b/man/tset.1 index 1c27efa4..91cceb20 100644 --- a/man/tset.1 +++ b/man/tset.1 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2016,2017 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2017,2018 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,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tset.1,v 1.50 2017/11/18 23:51:17 tom Exp $ +.\" $Id: tset.1,v 1.54 2018/07/28 21:30:27 tom Exp $ .TH @TSET@ 1 "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -56,7 +56,7 @@ standard output, .bP standard input and .bP -ultimately \*(lq/dev/tty\*(rq +ultimately \*(``/dev/tty\*('' .PP to obtain terminal settings. Having retrieved these settings, \fB@TSET@\fP remembers which @@ -82,7 +82,8 @@ option mappings are then applied (see the section .B TERMINAL TYPE MAPPING for more information). Then, if the terminal type begins with a question mark (\*(``?\*(''), the -user is prompted for confirmation of the terminal type. An empty +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, @@ -101,7 +102,8 @@ and \fBCOLUMNS\fP variables specify this), use this to set the operating system's notion of the window size. .bP if the \*(``\fB\-c\fP\*('' option is enabled, -the backspace, interrupt and line kill characters (among many other things) are set +the backspace, interrupt and line kill characters +(among many other things) are set .bP unless the \*(``\fB\-I\fP\*('' option is enabled, the terminal @@ -206,11 +208,13 @@ the terminal's capabilities into the shell's environment. This is done using the \fB\-s\fR option. .PP When the \fB\-s\fR option is specified, the commands to enter the information -into the shell's environment are written to the standard output. If +into the shell's environment are written to the standard output. +If the \fBSHELL\fR environmental variable ends in \*(``csh\*('', the commands are for \fBcsh\fR, otherwise, they are for \fBsh\fR. Note, the \fBcsh\fR commands set and unset the shell variable -\fBnoglob\fR, leaving it unset. The following line in the \fB.login\fR +\fBnoglob\fR, leaving it unset. +The following line in the \fB.login\fR or \fB.profile\fR files will initialize the environment correctly: .sp eval \`@TSET@ \-s options ... \` @@ -231,7 +235,8 @@ guess that I'm on that kind of terminal\*(''. .PP The argument to the \fB\-m\fR option consists of an optional port type, an optional operator, an optional baud rate specification, an optional -colon (\*(``:\*('') character and a terminal type. The port type is a +colon (\*(``:\*('') 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 \*(``>\*('', @@ -247,14 +252,17 @@ of the standard error output (which should be the control terminal). The terminal type is a string. .PP If the terminal type is not specified on the command line, the \fB\-m\fR -mappings are applied to the terminal type. If the port type and baud +mappings are applied to the terminal type. +If the port type and baud rate match the mapping, the terminal type specified in the mapping -replaces the current type. If more than one mapping is specified, the +replaces the current type. +If more than one mapping is specified, the first applicable mapping is used. .PP For example, consider the following mapping: \fBdialup>9600:vt100\fR. The port type is dialup , the operator is >, the baud rate -specification is 9600, and the terminal type is vt100. The result of +specification is 9600, and the terminal type is vt100. +The result of this mapping is to specify that if the terminal type is \fBdialup\fR, and the baud rate is greater than 9600 baud, a terminal type of \fBvt100\fR will be used. @@ -297,7 +305,7 @@ that he began work in October 1977, continuing development over the next few years. .PP In September 1980, Eric Allman modified \fBtset\fP, -adding the code from the existing \*(lqreset\*(rq +adding the code from the existing \*(``reset\*('' feature when \fBtset\fP was invoked as \fBreset\fP. Rather than simply copying the existing program, in this merged version, \fBtset\fP used the termcap database @@ -325,9 +333,10 @@ In fact, the commonly-used \fBreset\fP utility is always an alias for \fBtset\fP. .PP The \fB@TSET@\fR utility provides for backward-compatibility with BSD -environments (under most modern UNIXes, \fB/etc/inittab\fR and \fIgetty\fR(1) +environments (under most modern UNIXes, \fB/etc/inittab\fR and \fBgetty\fR(1) can set \fBTERM\fR appropriately for each dial-up line; this obviates what was -\fB@TSET@\fR's most important use). This implementation behaves like 4.4BSD +\fB@TSET@\fR's most important use). +This implementation behaves like 4.4BSD \fBtset\fP, with a few exceptions specified here. .PP A few options are different @@ -352,9 +361,11 @@ None of them were documented in 4.3BSD and all are of limited utility at best. The \fB\-a\fR, \fB\-d\fR, and \fB\-p\fR options are similarly not documented or useful, but were retained as they appear to be in -widespread use. It is strongly recommended that any usage of these +widespread use. +It is strongly recommended that any usage of these three options be changed to use the \fB\-m\fR option instead. -The \fB\-a\fP, \fB\-d\fP, and \fB\-p\fR options are therefore omitted from the usage summary above. +The \fB\-a\fP, \fB\-d\fP, and \fB\-p\fR options +are therefore omitted from the usage summary above. .PP Very old systems, e.g., 3BSD, used a different terminal driver which was replaced in 4BSD in the early 1980s.