]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/vt
merge
[plan9front.git] / sys / man / 1 / vt
1 .TH VT 1 
2 .SH NAME
3 vt \- emulate a VT-100 or VT-220 terminal
4 .SH SYNOPSIS
5 .B vt
6 [
7 .B -2abcx
8 ]
9 [
10 .B -f
11 .I font
12 ] [
13 .B -l
14 .I log
15 ]
16 .SH DESCRIPTION
17 .I Vt
18 replaces a
19 .I rio
20 window with a fresh instance of the shell,
21 .IR rc (1),
22 running within an emulation of a DEC VT-100 terminal.
23 To exit
24 .IR vt ,
25 exit the
26 .B rc
27 it starts.
28 .SS Options
29 .TF m
30 .TP
31 .B 2
32 .TP
33 .B a
34 .TP
35 .B x
36 change
37 .I vt
38 to emulate a VT-220, ANSI, or XTerm terminal respectively.
39 .TP
40 .B b
41 changes the color scheme to white text on a black background,
42 but potentially with colors from escape sequences.
43 .TP
44 .B c
45 changes the color scheme to monochrome (no colors).
46 .TP
47 .B f
48 sets the
49 .IR font .
50 .TP
51 .B l
52 names a
53 .I log
54 file for the session.
55 .SS Menus
56 The right button has a menu with the following entries to provide
57 the sort of character processing expected by non-Plan 9 systems:
58 .TF cooked
59 .TP
60 .B 24x80
61 Resize the
62 .I vt
63 window to hold 24 rows of 80 columns.
64 .TP
65 .B crnl
66 Print a newline (linefeed) character after receiving a carriage return from the host.
67 .TP
68 .B cr
69 Do not print a newline after carriage return.
70 .TP
71 .B nlcr
72 Print a carriage return after receiving a newline from the host.
73 .TP
74 .B nl
75 Do not print a carriage return after newline.
76 .TP
77 .B raw
78 Enter raw (no echo, no interpretation) character mode for input.
79 .TP
80 .B cooked
81 Leave raw mode.
82 .TP
83 .B exit
84 Exit
85 .IR vt .
86 .PD
87 .PP
88 The middle button has a menu with the following entries:
89 .TF right_key
90 .TP
91 .B backup
92 Move the display back one screenful.
93 .TP
94 .B forward
95 Move the display forward one screenful.
96 (These are a poor substitute for a scroll bar.)
97 .TP
98 .B reset
99 Display the last screenful; the same as going
100 .B forward
101 to the end.
102 .TP
103 .B clear
104 Clear the screen.  Previous contents can be recovered using
105 .BR backup .
106 .TP
107 .B send
108 Send the contents of the
109 .B rio
110 snarf buffer, just as
111 .B send
112 in the
113 .B rio
114 menu.
115 .TP
116 .B scroll
117 Make new lines visible as they appear at the bottom.
118 .TP
119 .B page
120 When the page fills, pause and wait for a character to be typed before proceeding.
121 The down arrow key advances a page without sending the character to the host.
122 .PD
123 .SH SOURCE
124 .B /sys/src/cmd/vt
125 .SH BUGS
126 This program is used only for communicating with foreign systems,
127 so it is not
128 as rich an emulation as its equivalent in other environments.
129 .PP
130 Use care in setting raw and newline modes when connecting to Unix systems
131 via
132 .IR con (1)
133 or
134 .IR ssh (1).
135 It may also be necessary to set the emulator into raw mode.